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
• Propriétés

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

13–65535

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 :

1. 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.

2. 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	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

CIM_NetworkAdapter

Classes matérielles du système informatique

Tâches WMI : Mise en réseau

Prise en charge d’IPv6 et IPv4 dans WMI