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
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:
- Win32 _ PnPEntity
- Win32 _ ComputerSystem
- Win32 _ NetworkAdapterConfiguration
- Win32 _ IRQResource
- Win32 _ DeviceMemoryAddress
- Win32 _ PortResource
- Win32 _ NetworkProtocol
- Win32 _ SystemDriver
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:
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 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 |
|
| DLL |
|