Freigeben über

CIM_NetworkAdapter-Klasse

  • Artikel

Die CIM_NetworkAdapter-Klasse ist eine abstrakte Klasse, die allgemeine Netzwerkhardwarekonzepte definiert (z. B. permanente Adresse oder Betriebsgeschwindigkeit). Die Informationen werden mithilfe der CIM_DeviceSAPImplementation-Zuordnung vermittelt.

Netzwerkadapter und zugehörige Endpunkte stellen das Potenzial für Konnektivität zwischen Peers dar. Das Konnektivitätspotenzial unterscheidet sich erheblich von den master- oder untergeordneten und Controller- oder kontrollierten Beziehungen von CIM_Controller. Gelegentlich fungiert jedoch ein einzelnes Gerät sowohl als Netzwerkadapter als auch als Controller, z. B. wenn ein Glasfaserkanaladapter als SCSI-Controller eines Computersystems fungiert. In diesem Fall sind Die Aspekte des Geräts netzwerkorientiert und andere sind controllerorientiert. Die Controller- und Adapterklassen sollten instanziiert werden, und es sollte auch eine Geräteidentitätsbeziehung erstellt werden, um die verschiedenen Aspekte des Geräts zu verknüpfen.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[Abstract, UUID("{8502C532-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_NetworkAdapter : CIM_LogicalDevice
{
  boolean  AutoSense;
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint64   MaxSpeed;
  string   Name;
  string   NetworkAddresses[];
  string   PermanentAddress;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint64   Speed;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Member

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

Methoden

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

Methode BESCHREIBUNG
Zurücksetzen Fordert eine Zurücksetzung des logischen Geräts an. Nicht von WMI implementiert.
SetPowerState Definiert den gewünschten Energiezustand für ein logisches Gerät und wann ein Gerät in diesen Zustand versetzt werden soll. Nicht von WMI implementiert.

Eigenschaften

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

Autosense

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Wenn TRUE, kann der Netzwerkadapter automatisch die Geschwindigkeit oder andere Kommunikationsmerkmale der angefügten Netzwerkmedien bestimmen.

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)

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 Energiesparmodus befindet, aber seine genaue status ist unbekannt.

Stromsparmodus – Energiesparmodus (14)

Das Gerät befindet sich im Energiesparmodus, funktioniert aber weiterhin und kann eine leistungseinbußen aufweisen.

Energiesparmodus – Standby (15)

Das Gerät funktioniert nicht, konnte aber schnell auf volle Leistung 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 Textbeschreibung des Objekts.

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)

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

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 kostenlose Ressourcen finden, um es zu verwenden.

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

Windows kann die Geräteressourcen nicht überprüfen.

Dieses Gerät kann erst ordnungsgemäß funktionieren, wenn Sie Ihren 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 erneuter Enumeration vorliegt. (15)

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

Windows kann nicht alle von diesem Gerät verwendeten Ressourcen identifizieren. (16)

Windows kann 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-Ladeprogramms. (19)

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

Die Registrierung kann beschädigt sein.

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 unwirksam 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 unwirksam 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 hat nicht alle Treiber installiert.

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

Windows richtet das Gerät weiterhin ein.

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

Windows richtet das Gerät weiterhin 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 -Ressource (IRQ), 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: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

CreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key

Name der Klasse oder Unterklasse, die bei der Erstellung einer instance verwendet wird. Bei Verwendung mit anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen der -Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DeviceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key

Adresse oder andere identifizierende Informationen, um das logische Gerät eindeutig zu benennen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorCleared

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Wenn true, wird der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt gelöscht.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorDescription

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Freiformzeichenfolge, die Informationen zu dem in der LastErrorCode-Eigenschaft aufgezeichneten Fehler und auszuführenden Korrekturmaßnahmen bereitstellt.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

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.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

MaxSpeed

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bits pro Sekunde")

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

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

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Name")

Bezeichnung, unter der das Objekt bekannt ist. Bei unterklassigen Klassen kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

NetworkAddresses

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

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

Liste der Netzwerkadressen für einen Adapter.

PermanentAddress

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

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

PNPDeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Win32 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)

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

Bei TRUE kann das Gerät energieverwaltet, d. h. in einen Energiesparmodus versetzt werden. Bei FALSE sollte der ganzzahlige Wert 1 ("Nicht unterstützt") der einzige Eintrag im PowerManagementCapabilities-Array sein.

Diese Eigenschaft gibt nicht an, ob Energieverwaltungsfeatures derzeit aktiviert sind oder wenn aktiviert, welche Features unterstützt werden. Weitere Informationen finden Sie im PowerManagementCapabilities-Array . Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

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 BPS. Für Endpunkte mit unterschiedlicher Bandbreite oder für Endpunkte, bei denen keine genaue Schätzung vorgenommen werden kann, sollte diese Eigenschaft die nominale Bandbreite enthalten.

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

Der Name der Eingrenzungsklasse des Systems.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. Name"), CIM_Key

Der Name des Bereichssystems.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Bemerkungen

Die CIM_NetworkAdapter-Klasse wird von CIM_LogicalDevice abgeleitet.

WMI implementiert diese Klasse nicht. Klassen, die von CIM_NetworkAdapter abgeleitet werden, finden Sie unter Win32-Klassen.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die vom DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, den Dokumentationsstandards des Microsoft SDK zu entsprechen oder weitere Informationen bereitzustellen.

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_LogicalDevice