Win32 _ NetworkAdapter-Klasse

Die Win32 _ NetworkAdapter-Klasse ist veraltet. Verwenden Sie stattdessen die MSFT _ NetAdapter-Klasse. Die WMI-Klasse _ Win32 NetworkAdapter stellt einen Netzwerkadapter eines Computers dar, auf dem ein Windows ausgeführt wird.

Win32 _ NetworkAdapter liefert nur IPv4-Daten. 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;
};

Members

Die Win32 _ NetworkAdapter-Klasse verfügt über die folgenden Membertypen:

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 unter Reset-Methode in CIM _ NetworkAdapter.
SetPowerState Nicht implementiert. Weitere Informationen zum Implementieren dieser Methode finden Sie unter der SetPowerState-Methode in CIM _ NetworkAdapter.

Eigenschaften

Die Win32 _ NetworkAdapter-Klasse verfügt über diese Eigenschaften.

AdapterType

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("DeviceIoControl::OID _ GEN MEDIA IN _ _ _ USE")

Verwendetes Netzwerkmedium. Die Netzwerkadapter lauten 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)")

GELDAUTOMATEN ("ATM")

Drahtlos ("Drahtlos")

Wireless Wireless (funkenloses Funken)

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

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)

GELDAUTOMATEN (8)

Drahtlos (9)

Wireless Wireless (10)

Bpc (11)

CoWan (12)

1394 (13)

Autosense

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass der Netzwerkadapter automatisch die Geschwindigkeit des angeschlossenen Mediums 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 | Operational State | 003.5", "MIB. IETF | HOST-RESOURCES-MIB.hrDeviceStatus")

Verfügbarkeit und Status des Geräts.

Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.

Sonstige (1)

Unbekannt (2)

Wird ausgeführt/Vollstrom (3)

Running or Full Power

Warnung (4)

Im Test (5)

Nicht zutreffend (6)

Ausschalten (7)

Off Line (8)

Off-Off-Dienst (9)

Heruntergestuft (10)

Nicht installiert (11)

Installationsfehler (12)

Energiesparen – Unbekannt (13)

Es ist bekannt, dass sich das Gerät im Zustand "Stromsparen" befindet, aber sein genauer Status ist unbekannt.

Stromsparen – Modus mit geringer Leistung (14)

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

Energiesparen – Standby (15)

Das Gerät funktioniert nicht, kann aber schnell voll in Betrieb gebracht werden.

Energiezyklus (16)

Energiesparen – Warnung (17)

Das Gerät befindet sich in einem Warnzustand, jedoch auch im Zustand "Stromsparen".

Angehalten (18)

Das Gerät wird angehalten.

Nicht bereit (19)

Das Gerät ist nicht bereit.

Nicht konfiguriert (20)

Das Gerät ist nicht konfiguriert.

Ruhen (21)

Das Gerät ist still.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des -Objekts– eine einzeilenbasierte Zeichenfolge.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

ConfigManagerErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Windows Konfigurations-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 hat möglicherweise nicht genügend Arbeitsspeicher oder andere Ressourcen. (3)

Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder das System hat möglicherweise 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 verwaltet werden kann. (5)

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

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

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

Kann nicht gefiltert werden. (7)

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

Das Treiberladegerät für das Gerät fehlt.

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

Das Gerät funktioniert nicht ordnungsgemäß. Die steuernde Firmware berichtet falsch über die Ressourcen für das Gerät.

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

Das Gerät kann nicht gestartet werden.

Fehler bei diesem Gerät. (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 freie Ressourcen für die Verwendung finden.

Windows können die Ressourcen dieses Geräts nicht überprüfen. (13)

Windows können die Ressourcen des Geräts nicht überprüfen.

Dieses Gerät funktioniert erst dann ordnungsgemäß, wenn Sie Ihren Computer neu starten. (14)

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

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

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

Windows können nicht alle Ressourcen identifizieren, die dieses Gerät verwendet. (16)

Windows können nicht alle Ressourcen identifizieren, die das Gerät verwendet.

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-Ladeers. (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 verfügt nicht über alle installierten Treiber. (24)

Das Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder verfügt nicht über alle installierten Treiber.

Windows wird dieses Gerät weiterhin eingerichtet. (25)

Windows Das Gerät wird weiterhin eingerichtet.

Windows wird dieses Gerät weiterhin eingerichtet. (26)

Windows Das Gerät wird weiterhin eingerichtet.

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 ihm nicht die erforderlichen Ressourcen zur Verfügung hat. (29)

Das Gerät ist deaktiviert. Die Gerätefirmware hat nicht die erforderlichen Ressourcen zur Verfügung stellt.

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

Das Gerät verwendet eine IRQ-Ressource, die ein anderes Gerät verwendet.

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

Das Gerät funktioniert nicht ordnungsgemäß. Windows die erforderlichen Gerätetreiber können nicht geladen werden.

ConfigManagerUserConfig

Datentyp: boolescher Wert

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-Taste

Der Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung einer -Instanz verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht die -Eigenschaft, dass alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.

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: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass der in LastErrorCode gemeldete Fehler jetzt nicht mehr angezeigt wird.

Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.

ErrorDescription

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Weitere Informationen zu dem in LastErrorCode aufgezeichneten Fehler und Informationen zu eventuell ergriffenen 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, der in der Systemregistrierung gespeichert ist.

Beispiel: 0

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installation date")

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: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: VERALTET, MappingStrings ("Win32Registry | Software Microsoft Windows NT \ \ \ \ \ \ CurrentVersion \ \ NetworkCards | DriverDate")

True gibt an, dass der Netzwerkadapter im System installiert ist.

InterfaceIndex

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Indexwert, der die lokale Netzwerkschnittstelle eindeutig identifiziert. Der Wert in dieser Eigenschaft entspricht dem Wert in der InterfaceIndex-Eigenschaft in der Instanz von Win32 _ IP4RouteTable, der die Netzwerkschnittstelle in der Routentabelle darstellt.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Letzter vom logischen Gerät gemeldeter Fehlercode.

Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.

MACAddress

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Device Input and Output Functions | DeviceIoControl")

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

Manufacturer

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry | Software Microsoft Windows NT \ \ \ \ \ \ CurrentVersion \ \ NetworkCards | Manufacturer")

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. Der Wert 0 (null) sollte verwendet werden, wenn die Zahl unbekannt ist.

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. Bei Unterklassen kann die Eigenschaft überschrieben werden, um eine Schlüsseleigenschaft zu sein.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

NetConnectionID

Datentyp: Zeichenfolge

Zugriffstyp: Lesen/Schreiben

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

NetConnectionStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Status der Netzwerkadapterverbindung mit dem Netzwerk.

Getrennt (0)

Herstellen einer Verbindung (1)

Verbunden (2)

Trennen (3)

Hardware nicht vorhanden (4)

Hardware deaktiviert (5)

Hardwarefehler (6)

Getrenntes Medium (7)

Authentifizierung (8)

Authentifizierung erfolgreich (9)

Authentifizierung fehlgeschlagen (10)

Ungültige Adresse (11)

Erforderliche Anmeldeinformationen (12)

Andere

13–65535

NetEnabled

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Adapter aktiviert ist. True gibt an, dass der Adapter aktiviert ist. Sie können die NIC mithilfe der Methoden Aktivieren und Deaktivieren 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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), MappingStrings ("MIF. |DMTF-Netzwerkadapter 802 Port | 001.2")

Netzwerkadresse, die in einem Adapter hart codiert ist. Diese hart codierte Adresse kann durch ein Firmwareupgrade oder eine Softwarekonfiguration geändert werden. Wenn dies der Fall ist, sollte dieses Feld aktualisiert werden, wenn die Änderung vorgenommen wird. Die Eigenschaft sollte leer gelassen werden, wenn keine hart codierte 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: boolescher Wert

Zugriffstyp: Schreibgeschützt

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

PNPDeviceID

Datentyp: Zeichenfolge

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 Funktionssatz ist unbekannt, oder die Informationen sind nicht verfügbar.

Automatisch eingegebene Energiesparmodi (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 Managed Object Format -Klassen (MOF).

Power-Bike unterstützt (6)

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

Timed Power On Supported (7)

Timed Power-On Supported

Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 (Power Cycle) und Time auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Ein-/Aus-Setzen festgelegt ist.

PowerManagementSupported

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass das Gerät mit Strom verwaltet werden kann (kann in den Modus "Aussetzen" und so weiter) übertragen werden. Die -Eigenschaft gibt nicht an, dass energieverwaltungsfeatures derzeit aktiviert sind, sondern nur, dass das logische Gerät energieverwaltungsfähig ist.

Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.

ProductName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry | Software Microsoft Windows NT \ \ \ \ \ \ CurrentVersion \ \ NetworkCards | ServiceName")

Produktname des Netzwerkadapters.

Beispiel: "Fast EtherLink XL"

Servicename

Datentyp: Zeichenfolge

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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktueller Status des Objekts. Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Wird beendet ("Wird beendet")

Dienst ("Dienst")

Striche ("Strich")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

StatusInfo

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | Operational State | 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.

Sonstige (1)

Unbekannt (2)

Aktiviert (3)

Deaktiviert (4)

Nicht zutreffend (5)

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagated ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel

Der Wert der CreationClassName-Eigenschaft des Bereichscomputers.

Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagated ("_ CIM-System.Name"), _ CIM-Schlüssel

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 Time")

Datum und Uhrzeit der letzten Zurücksetzung des Netzwerkadapters.

Bemerkungen

Die Win32 _ NetworkAdapter-Klasse wird von CIM _ NetworkAdapter abgeleitet.

In der folgenden Liste werden die Assoziatorklassen für Win32 _ NetworkAdapter beschrieben:

Viele Systeme verfügen über eine Reihe von Netzwerkadaptern. Verwenden Sie Folgendes als Referenz, um die aktuellen Adapter zu suchen:

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, rufen Sie wahrscheinlich mehr als einen gültigen Netzwerkadapter ab. Wenn dies der Fall ist, können Sie die folgenden Informationen verwenden, um Ihre Suche nach "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 suchen:

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

  2. Verwenden Sie InterfaceIndex, um den gewünschten Netzwerkadapter abzurufen.

    "SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere

Beispiele

Im PowerShell-Codebeispiel für zwei WMI-Funktionen im TechNet-Katalog wird Win32 _ NetworkAdapter verwendet, um das cmdlet get-NetAdapter Windows neu zu erstellen.

Das PowerShell-Beispiel Get-ComputerInfo – Query Computer Info From Local/Remote Computers - (WMI) im TechNet Gallery verwendet eine Reihe von Aufrufen von Hardware und Software, 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 https://msdn.microsoft.com/library/system.management.aspx namespace verwendet, um die aktuellen Netzwerkadapter auf dem lokalen Computer abzurufen.

Hinweis

https://msdn.microsoft.com/library/system.management.aspxenthält die ursprünglichen Klassen, die für den Zugriff auf WMI verwendet werden. 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 die aktuellen Netzwerkadapter auf dem lokalen Computer abgerufen werden.

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

Requirements (Anforderungen)

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

Weitere Informationen

CIM _ NetworkAdapter

Computersystemhardwareklassen

WMI-Aufgaben: Netzwerk

IPv6- und IPv4-Unterstützung in WMI