Win32_NetworkAdapter-Klasse

Artikel
06/12/2023

Die Win32_NetworkAdapter-Klasse ist veraltet. Verwenden Sie stattdessen die MSFT_NetAdapter-Klasse . Die Win32_NetworkAdapterWMI-Klasse stellt einen Netzwerkadapter eines Computers dar, auf dem ein Windows-Betriebssystem ausgeführt wird.

Win32_NetworkAdapter stellt nur IPv4-Daten bereit. Weitere Informationen finden Sie unter IPv6- und IPv4-Unterstützung in WMI.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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;
};

Member

Die Win32_NetworkAdapter-Klasse verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Die Win32_NetworkAdapter-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
Deaktivieren	Deaktiviert den Netzwerkadapter.
Aktivieren	Aktiviert den Netzwerkadapter.
Zurücksetzen	Nicht implementiert. Weitere Informationen zum Implementieren dieser Methode finden Sie in der Reset-Methode in CIM_NetworkAdapter.
SetPowerState	Nicht implementiert. Weitere Informationen zum Implementieren dieser Methode finden Sie in der SetPowerState-Methode in CIM_NetworkAdapter.

Eigenschaften

Die Win32_NetworkAdapter-Klasse verfügt über diese Eigenschaften.

AdapterType

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Verwendetes Netzwerkmedium. Die Netzwerkadapter sind wie folgt:

Ethernet 802.3 ("Ethernet 802.3")

Token ring 802.5 ("Token Ring 802.5")

Fiber Distributed Data Interface (FDDI) ("Fiber Distributed Data Interface (FDDI)")

Wide Area Network (WAN) ("Wide Area Network (WAN)")

LocalTalk ("LocalTalk")

Ethernet mit DIX-Headerformat ("Ethernet mit DIX-Headerformat")

ARCNET ("ARCNET")

ARCNET (878.2) ("ARCNET (878.2)")

ATM ("ATM")

Drahtlos ("Drahtlos")

Infrarot-Funk ("Infrarot-Funk")

Bpc ("Bpc")

CoWan ("CoWan")

1394 ("1394")

AdapterTypeID

Datentyp: uint16
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Verwendetes Netzwerkmedium. Gibt die gleichen Informationen wie die AdapterType-Eigenschaft zurück, mit der Ausnahme, dass die Informationen in Form einer ganzen Zahl vorliegen.

Ethernet 802.3 (0)

Token ring 802.5 (1)

Fiber Distributed Data Interface (FDDI) (2)

Wide Area Network (WAN) (3)

LocalTalk (4)

Ethernet mit DIX-Headerformat (5)

ARCNET (6)

ARCNET (878.2) (7)

ATM (8)

Drahtlos (9)

Infrarot-Funk (10)

Bpc (11)

CoWan (12)

1394 (13)

Autosense

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

True gibt an, dass der Netzwerkadapter automatisch die Geschwindigkeit der angefügten Medien oder des Netzwerkmediums bestimmen kann.

Diese Eigenschaft wird von CIM_NetworkAdapter geerbt.

Diese Eigenschaft wurde noch nicht implementiert. Standardmäßig wird ein NULL-Wert zurückgegeben.

Verfügbarkeit

Datentyp: uint16
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Verfügbarkeit und status des Geräts.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Sonstiges (1)

Unbekannt (2)

Running/Full Power (3)

"Running" oder "Full Power"

Warnung (4)

In Test (5)

Nicht zutreffend (6)

Ausschalten (7)

Off Line (8)

Off Duty (9)

Herabgestuft (10)

Nicht installiert (11)

Installationsfehler (12)

Stromsparen – Unbekannt (13)

Es ist bekannt, dass sich das Gerät in einem Energiesparzustand befindet, aber die genaue status ist unbekannt.

Stromsparmodus – Energiesparmodus (14)

Das Gerät befindet sich in einem Energiesparmodus, funktioniert aber weiterhin und kann eine beeinträchtigte Leistung aufweisen.

Energiesparmodus – Standby (15)

Das Gerät funktioniert nicht, konnte aber schnell auf Volle gebracht werden.

Stromversorgung (16)

Stromsparen – Warnung (17)

Das Gerät befindet sich in einem Warnzustand, aber auch im Energiesparmodus.

Angehalten (18)

Das Gerät ist angehalten.

Nicht bereit (19)

Das Gerät ist nicht bereit.

Nicht konfiguriert (20)

Das Gerät ist nicht konfiguriert.

Stilllegung (21)

Das Gerät ist ruhig.

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts – eine einzeilige Zeichenfolge.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ConfigManagerErrorCode

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32")

Windows Configuration Manager Fehlercode.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Dieses Gerät funktioniert ordnungsgemäß. (0)

Das Gerät funktioniert ordnungsgemäß.

Dieses Gerät ist nicht ordnungsgemäß konfiguriert. (1)

Das Gerät ist nicht ordnungsgemäß konfiguriert.

Windows kann den Treiber für dieses Gerät nicht laden. (2)

Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder Ihr System verfügt möglicherweise über wenig Arbeitsspeicher oder andere Ressourcen. (3)

Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder das System verfügt über wenig Arbeitsspeicher oder andere Ressourcen.

Dieses Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder Ihre Registrierung ist möglicherweise beschädigt. (4)

Das Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder die Registrierung ist möglicherweise beschädigt.

Der Treiber für dieses Gerät benötigt eine Ressource, die Windows nicht verwalten kann. (5)

Der Treiber für das Gerät erfordert eine Ressource, die Windows nicht verwalten kann.

Die Startkonfiguration für dieses Gerät ist in Konflikt mit anderen Geräten. (6)

Die Startkonfiguration für das Gerät ist in Konflikt mit anderen Geräten.

Filter kann nicht gefiltert werden. (7)

Das Treiberladeprogramm für das Gerät fehlt. (8)

Das Treiberladeprogramm für das Gerät fehlt.

Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch meldet. (9)

Das Gerät funktioniert nicht ordnungsgemäß. Die steuernde Firmware meldet die Ressourcen für das Gerät fälschlicherweise.

Dieses Gerät kann nicht gestartet werden. (10)

Das Gerät kann nicht gestartet werden.

Bei diesem Gerät ist ein Fehler aufgetreten. (11)

Fehler beim Gerät.

Dieses Gerät kann nicht genügend freie Ressourcen finden, die es verwenden kann. (12)

Das Gerät kann nicht genügend kostenlose Ressourcen finden, um es zu verwenden.

Windows kann die Ressourcen dieses Geräts nicht überprüfen. (13)

Windows kann die Ressourcen des Geräts nicht überprüfen.

Dieses Gerät kann erst dann ordnungsgemäß funktionieren, wenn Sie den Computer neu starten. (14)

Das Gerät kann erst dann ordnungsgemäß funktionieren, wenn der Computer neu gestartet wird.

Dieses Gerät funktioniert nicht ordnungsgemäß, da wahrscheinlich ein Problem mit einer erneuten Enumeration vorliegt. (15)

Das Gerät funktioniert aufgrund eines möglichen Problems mit einer erneuten Enumeration nicht ordnungsgemäß.

Windows kann nicht alle Ressourcen identifizieren, die von diesem Gerät verwendet werden. (16)

Windows kann nicht alle Ressourcen identifizieren, die vom Gerät verwendet werden.

Dieses Gerät fragt nach einem unbekannten Ressourcentyp. (17)

Das Gerät fordert einen unbekannten Ressourcentyp an.

Installieren Sie die Treiber für dieses Gerät neu. (18)

Gerätetreiber müssen neu installiert werden.

Fehler beim Verwenden des VxD-Ladeprogramms. (19)

Ihre Registrierung ist möglicherweise beschädigt. (20)

Die Registrierung ist möglicherweise beschädigt.

Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie ihre Hardwaredokumentation. Windows entfernt dieses Gerät. (21)

Systemfehler. Wenn das Ändern des Gerätetreibers ineffektiv ist, lesen Sie die Hardwaredokumentation. Windows entfernt das Gerät.

Dieses Gerät ist deaktiviert. (22)

Das Gerät ist deaktiviert.

Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie ihre Hardwaredokumentation. (23)

Systemfehler. Wenn das Ändern des Gerätetreibers ineffektiv ist, lesen Sie die Hardwaredokumentation.

Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder hat nicht alle Treiber installiert. (24)

Das Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß, oder es sind nicht alle Treiber installiert.

Windows richtet dieses Gerät noch ein. (25)

Windows richtet das Gerät noch ein.

Windows richtet dieses Gerät noch ein. (26)

Windows richtet das Gerät noch ein.

Dieses Gerät verfügt nicht über eine gültige Protokollkonfiguration. (27)

Das Gerät verfügt nicht über eine gültige Protokollkonfiguration.

Die Treiber für dieses Gerät sind nicht installiert. (28)

Gerätetreiber sind nicht installiert.

Dieses Gerät ist deaktiviert, da die Firmware des Geräts nicht die erforderlichen Ressourcen bereitgestellt hat. (29)

Das Gerät ist deaktiviert. Die Gerätefirmware hat nicht die erforderlichen Ressourcen bereitgestellt.

Dieses Gerät verwendet eine Interrupt Request (IRQ)-Ressource, die von einem anderen Gerät verwendet wird. (30)

Das Gerät verwendet eine IRQ-Ressource, die von einem anderen Gerät verwendet wird.

Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden kann. (31)

Das Gerät funktioniert nicht ordnungsgemäß. Windows kann die erforderlichen Gerätetreiber nicht laden.

ConfigManagerUserConfig

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32")

True gibt an, dass das Gerät eine benutzerdefinierte Konfiguration verwendet.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

CreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: CIM_Key

Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung eines instance verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht die -Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DeviceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, Override ("DeviceId"), MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Class\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Eindeutiger Bezeichner des Netzwerkadapters von anderen Geräten im System.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorCleared

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Wenn True, wird der in LastErrorCode gemeldete Fehler jetzt gelöscht.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorDescription

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Weitere Informationen zum in LastErrorCode aufgezeichneten Fehler und Informationen zu etwaigen Korrekturmaßnahmen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

GUID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Global eindeutiger Bezeichner für die Verbindung.

Index

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Class\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Indexnummer des Netzwerkadapters, gespeichert in der Systemregistrierung.

Beispiel: 0

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Diese Eigenschaft wurde noch nicht implementiert. Standardmäßig wird ein NULL-Wert zurückgegeben.

Installiert

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: VERALTET, MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| DriverDate")

Bei True wird der Netzwerkadapter im System installiert.

InterfaceIndex

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Indexwert, der die lokale Netzwerkschnittstelle eindeutig identifiziert. Der Wert in dieser Eigenschaft ist mit dem Wert in der Eigenschaft InterfaceIndex im instance von Win32_IP4RouteTable identisch, der die Netzwerkschnittstelle in der Routingtabelle darstellt.

LastErrorCode

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Letzter Fehlercode, der vom logischen Gerät gemeldet wurde.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

MACAddress

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Geräteeingabe- und Ausgabefunktionen | DeviceIoControl")

Adresse der Medienzugriffssteuerung für diesen Netzwerkadapter. Eine MAC-Adresse ist eine eindeutige 48-Bit-Nummer, die dem Netzwerkadapter vom Hersteller zugewiesen ist. Er identifiziert diesen Netzwerkadapter eindeutig und wird zum Zuordnen der TCP/IP-Netzwerkkommunikation verwendet.

Manufacturer

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| Hersteller")

Name des Herstellers des Netzwerkadapters.

Beispiel: "3COM"

MaxNumberControlled

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| Busport|001.9| Maximale Anzahl von Anlagen")

Maximale Anzahl direkt adressierbarer Ports, die von diesem Netzwerkadapter unterstützt werden. Wenn die Zahl unbekannt ist, sollte der Wert 0 (null) verwendet werden.

MaxSpeed

Datentyp: uint64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten ("Bits pro Sekunde")

Maximale Geschwindigkeit (in Bits pro Sekunde) für den Netzwerkadapter.

Diese Eigenschaft wird von CIM_NetworkAdapter geerbt.

Diese Eigenschaft wurde noch nicht implementiert. Standardmäßig wird ein NULL-Wert zurückgegeben.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Name

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Name")

Bezeichnung, unter der das Objekt bekannt ist. Wenn sie unterklassiert wird, kann die Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

NetConnectionID

Datentyp: Zeichenfolge
Zugriffstyp: Lese-/Schreibzugriff

Name der Netzwerkverbindung, wie er im Programm Netzwerkverbindungen Systemsteuerung angezeigt wird.

NetConnectionStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Status der Netzwerkadapterverbindung mit dem Netzwerk.

Getrennt (0)

Verbinden (1)

Verbunden (2)

Trennen ( 3)

Hardware nicht vorhanden (4)

Hardware deaktiviert (5)

Hardwarefehler (6)

Medien getrennt (7)

Authentifizieren (8)

Authentifizierung erfolgreich (9)

Fehler bei der Authentifizierung (10)

Ungültige Adresse (11)

Erforderliche Anmeldeinformationen (12)

Andere

13–65535

NetEnabled

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

Gibt an, ob der Adapter aktiviert ist. True gibt an, dass der Adapter aktiviert ist. Sie können die NIC mit den Methoden Enable und Disable aktivieren oder deaktivieren.

NetworkAddresses

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), MappingStrings ("MIF. DMTF| Netzwerkadapter 802 Port|001.3")

Array von Netzwerkadressen für einen Adapter.

Diese Eigenschaft wird von CIM_NetworkAdapter geerbt.

Diese Eigenschaft wurde noch nicht implementiert. Standardmäßig wird ein NULL-Wert zurückgegeben.

PermanentAddress

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), MappingStrings ("MIF. DMTF| Netzwerkadapter 802 Port|001.2")

Netzwerkadresse, die in einen Adapter hartcodiert ist. Diese hartcodierte Adresse kann durch Firmwareupgrade oder Softwarekonfiguration geändert werden. Wenn dies der Fall ist, sollte dieses Feld aktualisiert werden, wenn die Änderung vorgenommen wird. Die Eigenschaft sollte leer bleiben, wenn keine hartcodierte Adresse für den Netzwerkadapter vorhanden ist.

Diese Eigenschaft wird von CIM_NetworkAdapter geerbt.

Diese Eigenschaft wurde noch nicht implementiert. Standardmäßig wird ein NULL-Wert zurückgegeben.

PhysicalAdapter

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

Gibt an, ob der Adapter ein physischer oder ein logischer Adapter ist. True gibt an, dass der Adapter physisch ist.

PNPDeviceID

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32")

Windows Plug & Play Gerätebezeichner des logischen Geräts.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Beispiel: "*PNP030b"

PowerManagementCapabilities

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Array der spezifischen energiebezogenen Funktionen eines logischen Geräts.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Unbekannt (0)

Nicht unterstützt (1)

Deaktiviert (2)

Aktiviert (3)

Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.

Energiesparmodi werden automatisch eingegeben (4)

Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.

Power State Settable (5)

Die SetPowerState-Methode wird unterstützt. Diese Methode befindet sich in der übergeordneten CIM_LogicalDevice Klasse und kann implementiert werden. Weitere Informationen finden Sie unter Entwerfen von MOF-Klassen (Managed Object Format).

Power Cycling Wird unterstützt (6)

Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 (Power Cycle) festgelegt ist.

Timed Power On Supported (7)

Unterstützte zeitlimitierte Power-On

Die SetPowerState-Methode kann aufgerufen werden, wobei der PowerState-Parameter auf 5 (Power Cycle) und Time auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall festgelegt ist, um ein einschalten zu können.

PowerManagementSupported

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

True gibt an, dass das Gerät mit Strom verwaltet werden kann (kann in den Anhaltemodus versetzt werden usw.). Die -Eigenschaft gibt nicht an, dass Energieverwaltungsfeatures derzeit aktiviert sind, nur, dass das logische Gerät energieverwaltungsfähig ist.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ProductName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ServiceName")

Produktname des Netzwerkadapters.

Beispiel: "Fast EtherLink XL"

ServiceName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ProductName")

Dienstname des Netzwerkadapters. Dieser Name ist in der Regel kürzer als der vollständige Produktname.

Beispiel: "Elnkii"

Geschwindigkeit

Datentyp: uint64
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIB. IETF| RFC1213-MIB.ifSpeed", "MIF. DMTF| Netzwerkadapter 802 Port|001.5"), Einheiten ("Bits pro Sekunde")

Schätzung der aktuellen Bandbreite in Bits pro Sekunde. Für Endpunkte, die in der Bandbreite variieren, oder für Endpunkte, bei denen keine genaue Schätzung vorgenommen werden kann, sollte diese Eigenschaft die nominale Bandbreite enthalten.

Diese Eigenschaft wird von CIM_NetworkAdapter geerbt.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktuelle status des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

StatusInfo

Datentyp: uint16
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.3")

Status des logischen Geräts. Wenn diese Eigenschaft nicht für das logische Gerät gilt, sollte der Wert 5 (Nicht zutreffend) verwendet werden.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Sonstiges (1)

Unbekannt (2)

Aktiviert (3)

Deaktiviert (4)

Nicht zutreffend (5)

SystemCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_System. CreationClassName"), CIM_Key

Wert der CreationClassName-Eigenschaft des Bereichscomputers.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Systemname

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_System. Name"), CIM_Key

Name des Bereichssystems.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

TimeOfLastReset

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009| System-Up-Zeit")

Datum und Uhrzeit des letzten Zurücksetzens des Netzwerkadapters.

Bemerkungen

Die Win32_NetworkAdapter-Klasse wird von CIM_NetworkAdapter abgeleitet.

In der folgenden Liste werden die Associator-Klassen für Win32_NetworkAdapter beschrieben:

Viele Systeme verfügen über eine Reihe von Netzwerkadaptern. Erwägen Sie, folgendes als Referenz zu verwenden, um die aktuellen Adapter zu finden:

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>

Selbst wenn Sie die oben genannten Qualifizierer verwenden, werden Sie wahrscheinlich mehr als einen gültigen Netzwerkadapter abrufen. Wenn dies der Fall ist, können Sie die folgenden Informationen verwenden, um Ihre Suche nach dem Win32_NetworkAdapterConfiguration weiter zu qualifizieren:

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

Sobald Sie dies getan haben, haben Sie Ihre Liste wahrscheinlich auf einen oder zwei konfigurierte Adapter reduziert.

Sie können auch das folgende Verfahren verwenden, um den Standardadapter zu ermitteln:

Führen Sie die folgende Abfrage aus:

"SELECT InterfaceIndex, Destination FROM Win32_IP4RouteTable WHERE Destination='0.0.0.0'"

Sie sollten nur über ein Standardnetzwerkziel 0.0.0.0 verfügen.
Verwenden Sie interfaceIndex , um den gewünschten Netzwerkadapter abzurufen.

"SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere

Beispiele

Im PowerShell-Codebeispiel Zwei WMI-Funktionen im TechNet-Katalog wird Win32_NetworkAdapter verwendet, um das Windows Get-NetAdapter-Cmdlet neu zu erstellen.

Das PowerShell-Beispiel Get-ComputerInfo – Abfragen von Computerinformationen von lokalen/Remotecomputern (WMI) im TechNet-Katalog verwendet eine Reihe von Hardware- und Softwareaufrufen, einschließlich Win32_NetworkAdapter, um Informationen zu einem lokalen oder Remotesystem anzuzeigen.

Im folgenden C#-Codebeispiel wird der Microsoft.Management.Infrastructure-Namespace verwendet, um die aktuellen Netzwerkadapter auf dem lokalen Computer abzurufen.

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();
        }

Im folgenden C#-Codebeispiel wird namespace verwendet https://msdn.microsoft.com/library/system.management.aspx , um die aktuellen Netzwerkadapter auf dem lokalen Computer abzurufen.

Hinweis

https://msdn.microsoft.com/library/system.management.aspx enthält die ursprünglichen Klassen, die für den Zugriff auf WMI verwendet wurden; Sie gelten jedoch als langsamer und skalieren im Allgemeinen nicht so gut wie ihre Microsoft.Management.Infrastructure-Entsprechungen .

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();

        }

Im folgenden VBScript-Codebeispiel wird beschrieben, wie Sie die aktuellen Netzwerkadapter auf dem lokalen Computer abrufen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_NetworkAdapter
Hardwareklassen des Computersystems
WMI-Aufgaben: Netzwerk
IPv6- und IPv4-Unterstützung in WMI

Freigeben über

Win32_NetworkAdapter-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen