classe Win32_NetworkAdapter
La classe Win32_NetworkAdapter est déconseillée. Utilisez plutôt la classe MSFT_NetAdapter . La classe WMIWin32_NetworkAdapter représente une carte réseau d’un ordinateur exécutant un système d’exploitation Windows.
Win32_NetworkAdapter fournit uniquement des données IPv4. Pour plus d’informations, consultez Prise en charge IPv6 et IPv4 dans WMI.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[Dynamic, Provider("CIMWin32"), UUID("{8502C4C0-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkAdapter : CIM_NetworkAdapter
{
string AdapterType;
uint16 AdapterTypeID;
boolean AutoSense;
uint16 Availability;
string Caption;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
string GUID;
uint32 Index;
datetime InstallDate;
boolean Installed;
uint32 InterfaceIndex;
uint32 LastErrorCode;
string MACAddress;
string Manufacturer;
uint32 MaxNumberControlled;
uint64 MaxSpeed;
string Name;
string NetConnectionID;
uint16 NetConnectionStatus;
boolean NetEnabled;
string NetworkAddresses[];
string PermanentAddress;
boolean PhysicalAdapter;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string ProductName;
string ServiceName;
uint64 Speed;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
datetime TimeOfLastReset;
};
Membres
La classe Win32_NetworkAdapter a les types de membres suivants :
Méthodes
La classe Win32_NetworkAdapter a ces méthodes.
| Méthode | Description |
|---|---|
| Désactiver | Désactive la carte réseau. |
| Activer | Active la carte réseau. |
| Réinitialiser | Non implémenté. Pour plus d’informations sur l’implémentation de cette méthode, consultez la méthode Reset dans CIM_NetworkAdapter. |
| SetPowerState | Non implémenté. Pour plus d’informations sur l’implémentation de cette méthode, consultez la méthode SetPowerState dans CIM_NetworkAdapter. |
Propriétés
La classe Win32_NetworkAdapter possède ces propriétés.
-
AdapterType
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« DeviceIoControl::OID_GEN_MEDIA_IN_USE »)
Support réseau en cours d’utilisation. Les cartes réseau sont les suivantes :
-
-
Ethernet 802.3 (« Ethernet 802.3 »)
-
Token Ring 802.5 (« Token Ring 802.5 »)
-
Fiber Distributed Data Interface (FDDI) (« Fiber Distributed Data Interface (FDDI) »)
-
Réseau étendu (WAN) (« réseau étendu (WAN) »)
-
LocalTalk (« LocalTalk »)
-
Ethernet utilisant le format d’en-tête DIX (« Ethernet utilisant le format d’en-tête DIX »)
-
ARCNET (« ARCNET »)
-
ARCNET (878.2) (« ARCNET (878.2) »)
-
ATM (« ATM »)
-
Sans fil (« sans fil »)
-
Infrarouge sans fil (« infrarouge sans fil »)
-
Bpc (« Bpc »)
-
CoWan (« CoWan »)
-
1394 (« 1394 »)
AdapterTypeID
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« DeviceIoControl::OID_GEN_MEDIA_IN_USE »)
Support réseau en cours d’utilisation. Retourne les mêmes informations que la propriété AdapterType , sauf que les informations sont sous la forme d’un entier.
Ethernet 802.3 (0)
Token Ring 802.5 (1)
Fiber Distributed Data Interface (FDDI) (2)
Réseau étendu (WAN) (3)
LocalTalk (4)
Ethernet utilisant le format d’en-tête DIX (5)
ARCNET (6)
ARCNET (878.2) (7)
ATM (8)
Sans fil (9)
Infrarouge sans fil (10)
Bpc (11)
CoWan (12)
1394 (13)
Autosense
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est True, la carte réseau peut déterminer automatiquement la vitesse du média connecté ou réseau.
Cette propriété est héritée de CIM_NetworkAdapter.
Cette propriété n’a pas encore été implémentée. Il retourne une valeur NULL par défaut.
Disponibilité
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)
Disponibilité et status de l’appareil.
Cette propriété est héritée de CIM_LogicalDevice.
Autre (1)
Inconnu (2)
En cours d’exécution/pleine puissance (3)
En cours d’exécution ou plein régime
Avertissement (4)
Dans le test (5)
Non applicable (6)
Mise hors tension (7)
Hors ligne (8)
Hors service (9)
Dégradé ( 10)
Non installé (11)
Erreur d’installation (12)
Power Save - Inconnu (13)
L’appareil est connu pour être dans un état d’économie d’énergie, mais son status exact est inconnu.
Économie d’énergie - Mode Faible consommation (14)
L’appareil est dans un état d’économie d’énergie, mais toujours en fonctionnement, et peut présenter des performances dégradées.
Économie d’alimentation - Veille (15)
L’appareil ne fonctionne pas, mais peut être porté à pleine puissance rapidement.
Cycle d’alimentation (16)
Power Save - Avertissement (17)
L’appareil est dans un état d’avertissement, mais également dans un état d’économie d’énergie.
Suspendu (18)
L’appareil est suspendu.
Pas prêt (19)
Le périphérique n’est pas prêt.
Non configuré (20)
L’appareil n’est pas configuré.
Quiesced (21)
L’appareil est silencieux.
Caption
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName (« Caption »)
Brève description de l’objet : une chaîne d’une ligne.
Cette propriété est héritée de CIM_ManagedSystemElement.
ConfigManagerErrorCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Code d’erreur windows Configuration Manager.
Cette propriété est héritée de CIM_LogicalDevice.
Cet appareil fonctionne correctement. (0)
L’appareil fonctionne correctement.
Cet appareil n’est pas configuré correctement. (1)
L’appareil n’est pas configuré correctement.
Windows ne peut pas charger le pilote pour cet appareil. (2)
Le pilote de cet appareil est peut-être endommagé ou votre système est peut-être à court de mémoire ou d’autres ressources. (3)
Le pilote de cet appareil peut être endommagé, ou le système peut être faible en mémoire ou d’autres ressources.
Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre peut être endommagé. (4)
L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le registre peut être endommagé.
Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)
Le pilote de l’appareil nécessite une ressource que Windows ne peut pas gérer.
La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)
La configuration de démarrage de l’appareil est en conflit avec d’autres appareils.
Impossible de filtrer. (7)
Le chargeur de pilotes pour l’appareil est manquant. (8)
Le chargeur de pilotes pour l’appareil est manquant.
Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)
L’appareil ne fonctionne pas correctement. Le microprogramme de contrôle signale de manière incorrecte les ressources de l’appareil.
Cet appareil ne peut pas démarrer. (10)
L’appareil ne peut pas démarrer.
Cet appareil a échoué. (11)
Échec de l’appareil.
Cet appareil ne trouve pas suffisamment de ressources gratuites qu’il peut utiliser. (12)
L’appareil ne trouve pas suffisamment de ressources gratuites à utiliser.
Windows ne peut pas vérifier les ressources de cet appareil. (13)
Windows ne peut pas vérifier les ressources de l’appareil.
Cet appareil ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)
L’appareil ne peut pas fonctionner correctement tant que l’ordinateur n’est pas redémarré.
Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de nouvelle énumération. (15)
L’appareil ne fonctionne pas correctement en raison d’un problème possible de nouvelle énumération.
Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)
Windows ne peut pas identifier toutes les ressources utilisées par l’appareil.
Cet appareil demande un type de ressource inconnu. (17)
L’appareil demande un type de ressource inconnu.
Réinstallez les pilotes pour ce périphérique. (18)
Les pilotes de périphérique doivent être réinstallés.
Échec de l’utilisation du chargeur VxD. (19)
Votre registre est peut-être endommagé. (20)
Le Registre est peut-être endommagé.
Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. Windows supprime cet appareil. (21)
Défaillance du système. Si la modification du pilote de périphérique est inefficace, consultez la documentation matérielle. Windows supprime l’appareil.
Cet appareil est désactivé. (22)
L’appareil est désactivé.
Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. (23)
Défaillance du système. Si la modification du pilote de périphérique est inefficace, consultez la documentation matérielle.
Cet appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés. (24)
L’appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés.
Windows est toujours en cours de configuration de cet appareil. (25)
Windows configure toujours l’appareil.
Windows est toujours en cours de configuration de cet appareil. (26)
Windows configure toujours l’appareil.
Cet appareil n’a pas de configuration de journal valide. (27)
L’appareil n’a pas de configuration de journal valide.
Les pilotes de ce périphérique ne sont pas installés. (28)
Les pilotes de périphérique ne sont pas installés.
Cet appareil est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources nécessaires. (29)
L’appareil est désactivé. Le microprogramme de l’appareil n’a pas fourni les ressources requises.
Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)
L’appareil utilise une ressource IRQ qu’un autre appareil utilise.
Cet appareil ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. (31)
L’appareil ne fonctionne pas correctement. Windows ne peut pas charger les pilotes de périphérique requis.
ConfigManagerUserConfig
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Si la valeur est True, l’appareil utilise une configuration définie par l’utilisateur.
Cette propriété est héritée de CIM_LogicalDevice.
CreationClassName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : CIM_Key
Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée lors de la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés de clé de la classe, la propriété permet à toutes les instances de cette classe et à ses sous-classes d’être identifiées de manière unique.
Cette propriété est héritée de CIM_LogicalDevice.
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Description »)
Description de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
DeviceID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, Override (« DeviceId »), MappingStrings (« Win32Registry| System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318} »)
Identificateur unique de la carte réseau d’autres appareils sur le système.
Cette propriété est héritée de CIM_LogicalDevice.
ErrorCleared
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est True, l’erreur signalée dans LastErrorCode est maintenant effacée.
Cette propriété est héritée de CIM_LogicalDevice.
ErrorDescription
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Plus d’informations sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives qui peuvent être prises.
Cette propriété est héritée de CIM_LogicalDevice.
GUID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Identificateur global unique de la connexion.
Index
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry| System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318} »)
Numéro d’index de la carte réseau, stocké dans le registre système.
Exemple : 0
InstallDate
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)
Date et heure d’installation de l’objet. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
Cette propriété n’a pas encore été implémentée. Elle retourne une valeur NULL par défaut.
Installé
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : DEPRECATED, MappingStrings (« Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| DriverDate »)
Si la valeur est True, la carte réseau est installée dans le système.
InterfaceIndex
-
Type de données : uint32
-
Type d'accès : Lecture seule
Valeur d’index qui identifie de manière unique l’interface réseau locale. La valeur de cette propriété est identique à la valeur de la propriété InterfaceIndex dans le instance de Win32_IP4RouteTable qui représente l’interface réseau dans la table de routage.
LastErrorCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
Dernier code d’erreur signalé par l’appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
MACAddress
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Fonctions d’entrée et de sortie de l’appareil | DeviceIoControl »)
Adresse de contrôle d’accès multimédia pour cette carte réseau. Une adresse MAC est un numéro unique de 48 bits attribué à la carte réseau par le fabricant. Il identifie de manière unique cette carte réseau et est utilisé pour le mappage des communications réseau TCP/IP.
Fabricant
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| Fabricant »)
Nom du fabricant de la carte réseau.
Exemple : « 3COM »
MaxNumberControl
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Port de bus|001.9| Nombre maximal de pièces jointes »)
Nombre maximal de ports directement adressables pris en charge par cette carte réseau. Une valeur de 0 (zéro) doit être utilisée si le nombre est inconnu.
Maxspeed
-
Type de données : uint64
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (« bits par seconde »)
Vitesse maximale, en bits par seconde, pour la carte réseau.
Cette propriété est héritée de CIM_NetworkAdapter.
Cette propriété n’a pas encore été implémentée. Elle retourne une valeur NULL par défaut.
Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Name »)
Étiquette par laquelle l’objet est connu. En cas de sous-classe, la propriété peut être remplacée pour être une propriété de clé.
Cette propriété est héritée de CIM_ManagedSystemElement.
NetConnectionID
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
Nom de la connexion réseau telle qu’elle apparaît dans le programme Connexions réseau Panneau de configuration.
NetConnectionStatus
-
Type de données : uint16
-
Type d'accès : Lecture seule
État de la connexion de la carte réseau au réseau.
Déconnecté ( 0)
Connexion (1)
Connecté (2)
Déconnexion (3)
Matériel non présent (4)
Matériel désactivé (5)
Dysfonctionnement matériel (6)
Média déconnecté (7)
Authentification (8)
Authentification réussie (9)
Échec de l’authentification (10)
Adresse non valide (11)
Informations d’identification requises (12)
Autres
NetEnabled
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si l’adaptateur est activé ou non. Si la valeur est True, l’adaptateur est activé. Vous pouvez activer ou désactiver la carte réseau à l’aide des méthodes Enable et Disable .
NetworkAddresses
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), MappingStrings (« MIF. DMTF| Carte réseau 802 Port|001.3 »)
Tableau d’adresses réseau pour une carte.
Cette propriété est héritée de CIM_NetworkAdapter.
Cette propriété n’a pas encore été implémentée. Il retourne une valeur NULL par défaut.
Adresse permanente
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), MappingStrings (« MIF. DMTF| Carte réseau 802 Port|001.2 »)
Adresse réseau codée en dur dans une carte. Cette adresse codée en dur peut être modifiée par la mise à niveau du microprogramme ou la configuration logicielle. Si c’est le cas, ce champ doit être mis à jour lorsque la modification est apportée. La propriété doit être laissée vide si aucune adresse codée en dur n’existe pour la carte réseau.
Cette propriété est héritée de CIM_NetworkAdapter.
Cette propriété n’a pas encore été implémentée. Il retourne une valeur NULL par défaut.
PhysicalAdapter
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si l’adaptateur est un adaptateur physique ou logique. Si la valeur est True, l’adaptateur est physique.
PNPDeviceID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Windows Plug-and-Play identificateur d’appareil de l’appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
Exemple : « *PNP030b »
PowerManagementCapabilities
-
Type de données : uint16 array
-
Type d'accès : Lecture seule
Tableau des fonctionnalités spécifiques liées à l’alimentation d’un appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
Inconnu (0)
Non pris en charge (1)
Désactivé (2)
Activé (3)
Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble de fonctionnalités exact est inconnu ou les informations ne sont pas disponibles.
Modes d’économie d’énergie entrés automatiquement (4)
L’appareil peut modifier son état d’alimentation en fonction de l’utilisation ou d’autres critères.
Power State Settable (5)
La méthode SetPowerState est prise en charge. Cette méthode se trouve dans la classe parente CIM_LogicalDevice et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).
Prise en charge du cycle d’alimentation (6)
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (Cycle d’alimentation).
Prise en charge de l’alimentation chrono timed ( 7)
Power-On chronoté pris en charge
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (Cycle d’alimentation) et time défini sur une date et une heure spécifiques, ou intervalle, pour la mise sous tension.
PowerManagementSupported
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est True, l’appareil peut être géré par l’alimentation (peut être mis en mode interruption, etc.). La propriété n’indique pas que les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais seulement que l’appareil logique est capable de gérer l’alimentation.
Cette propriété est héritée de CIM_LogicalDevice.
ProductName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ServiceName »)
Nom du produit de la carte réseau.
Exemple : « Fast EtherLink XL »
ServiceName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ProductName »)
Nom du service de la carte réseau. Ce nom est généralement plus court que le nom complet du produit.
Exemple : « Elnkii »
Vitesse
-
Type de données : uint64
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIB. IETF| RFC1213-MIB.ifSpeed », « MIF. DMTF| Carte réseau 802 Port|001.5 « ), unités (« bits par seconde »)
Estimation de la bande passante actuelle en bits par seconde. Pour les points de terminaison qui varient en bande passante ou pour ceux pour lesquels aucune estimation précise ne peut être effectuée, cette propriété doit contenir la bande passante nominale.
Cette propriété est héritée de CIM_NetworkAdapter.
Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName (« Status »)
Status actuelle de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement.
Les valeurs sont notamment les suivantes :
OK (« OK »)
Erreur (« Erreur »)
Détérioré (« Détérioré »)
Inconnu (« Inconnu »)
Échec de la préversion (« Échec prédé »)
Démarrage (« Démarrage »)
Arrêt (« Arrêt »)
Service (« Service »)
Stressé (« Stressé »)
NonRecover (« NonRecover »)
Aucun contact (« Aucun contact »)
Lost Comm (« Lost Comm »)
StatusInfo
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.3 »)
État de l’appareil logique. Si cette propriété ne s’applique pas à l’appareil logique, la valeur 5 (Non applicable) doit être utilisée.
Cette propriété est héritée de CIM_LogicalDevice.
Autre (1)
Inconnu (2)
Activé (3)
Désactivé (4)
Non applicable (5)
SystemCreationClassName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. CreationClassName »), CIM_Key
Valeur de la propriété CreationClassName de l’ordinateur d’étendue.
Cette propriété est héritée de CIM_LogicalDevice.
SystemName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. Nom « ), CIM_Key
Nom du système d’étendue.
Cette propriété est héritée de CIM_LogicalDevice.
TimeOfLastReset
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\\009| Durée de fonctionnement du système »)
Date et heure de la dernière réinitialisation de la carte réseau.
Notes
La classe Win32_NetworkAdapter est dérivée de CIM_NetworkAdapter.
La liste suivante décrit les classes associateurs pour Win32_NetworkAdapter :
- Win32_PnPEntity
- Win32_ComputerSystem
- Win32_NetworkAdapterConfiguration
- Win32_IRQResource
- Win32_DeviceMemoryAddress
- Win32_PortResource
- Win32_NetworkProtocol
- Win32_SystemDriver
De nombreux systèmes disposent d’un certain nombre de cartes réseau. Envisagez d’utiliser les éléments suivants comme référence pour rechercher les adaptateurs actuels :
AdapterType: "Ethernet 802.3"
MACAddress: String Length > 16
Availability: 3
PNPDeviceID: InStr ( PNPDeviceID, "PCI") = 1
Installed: vbTrue
ConfigManagerErrorCode: 0
: <keep this as an index to Win32_NetworkAdapterConfiguration>
Même en utilisant les qualificateurs ci-dessus, vous récupérerez probablement plusieurs cartes réseau valides. Si tel est le cas, vous pouvez utiliser les informations suivantes pour qualifier davantage votre recherche du Win32_NetworkAdapterConfiguration :
Index: <match to DeviceID above>
MACAddress: Length > 16
DefaultIPGateway: String Length > 6
DNSServerSearchOrder: Array of strings with length > 6
IPEnabled: vbTrue
IPAddress: Array of strings with length > 6
Une fois que vous l’avez fait, vous aurez probablement réduit votre liste à un ou deux adaptateurs configurés.
Vous pouvez également utiliser la procédure suivante pour rechercher l’adaptateur par défaut :
Exécutez la requête suivante :
"SELECT InterfaceIndex, Destination FROM Win32_IP4RouteTable WHERE Destination='0.0.0.0'"Vous ne devez avoir qu’une seule destination réseau par défaut 0.0.0.0.
Utilisez InterfaceIndex pour récupérer la carte réseau souhaitée.
"SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere
Exemples
L’exemple de code PowerShell Two WMI Functions dans techNet Gallery utilise Win32_NetworkAdapter pour recréer l’applet de commande Windows Get-NetAdapter .
L’exemple PowerShell Get-ComputerInfo - Interroger les informations de l’ordinateur à partir d’ordinateurs locaux/distants (WMI) sur TechNet Gallery utilise un certain nombre d’appels au matériel et aux logiciels, y compris Win32_NetworkAdapter, pour afficher des informations sur un système local ou distant.
L’exemple de code C# suivant utilise l’espace de noms Microsoft.Management.Infrastructure pour récupérer les cartes réseau actuelles sur l’ordinateur local.
using Microsoft.Management.Infrastructure;
...
static void QueryInstanceFunc()
{
CimSession session = CimSession.Create("localHost");
IEnumerable<CimInstance> queryInstance = session.QueryInstances(@"root\cimv2", "WQL", "SELECT * FROM Win32_NetworkAdapter");
foreach (CimInstance cimObj in queryInstance)
{
Console.WriteLine(cimObj.CimInstanceProperties["Name"].ToString());
Console.WriteLine(cimObj.CimInstanceProperties["Description"].ToString());
Console.WriteLine();
}
Console.ReadLine();
}
L’exemple de code C# suivant utilise https://msdn.microsoft.com/library/system.management.aspx l’espace de noms pour récupérer les cartes réseau actuelles sur l’ordinateur local.
Notes
https://msdn.microsoft.com/library/system.management.aspx contient les classes d’origine utilisées pour accéder à WMI ; toutefois, ils sont considérés comme plus lents et ne sont généralement pas mis à l’échelle aussi bien que leurs équivalents Microsoft.Management.Infrastructure .
using System.Management;
...
static void oldSchoolQueryInstanceFunc()
{
ObjectQuery query = new ObjectQuery("SELECT * FROM Win32_NetworkAdapter");
ManagementObjectSearcher searcher = new ManagementObjectSearcher(query);
ManagementObjectCollection queryCollection = searcher.Get();
foreach (ManagementObject m in queryCollection)
{
Console.WriteLine("ServiceName : {0}", m["Name"]);
Console.WriteLine("MACAddress : {0}", m["Description"]);
Console.WriteLine();
}
Console.ReadLine();
}
L’exemple de code VBScript suivant décrit comment récupérer les cartes réseau actuelles sur l’ordinateur local.
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2")
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_NetworkAdapter")
For Each objItem in colItems
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo
Next
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour