Win32_PnPEntity-Klasse

  • Artikel

Die Win32_PnPEntityWMI-Klasse stellt die Eigenschaften eines Plug & Play Geräts dar. Plug & Play Entitäten werden als Einträge im Geräte-Manager in Systemsteuerung angezeigt.

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("{FE28FD98-C875-11d2-B352-00104BC97924}"), AMENDMENT]
class Win32_PnPEntity : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  string   ClassGuid;
  string   CompatibleID[];
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   HardwareID[];
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Manufacturer;
  string   Name;
  string   PNPClass;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  boolean  Present;
  string   Service;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Member

Die Win32_PnPEntity-Klasse weist die folgenden Typen von Membern auf:

Methoden

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

Methode BESCHREIBUNG
Deaktivieren Deaktiviert dieses Plug & Play-Gerät.
Aktivieren Aktiviert dieses Plug & Play-Gerät.
GetDeviceProperties Ruft die angegebenen Eigenschaften dieses Plug & Play Geräts ab.
Zurücksetzen Nicht implementiert. Informationen zum Implementieren dieser Methode finden Sie unter Reset-Methode in CIM_LogicalDevice.
SetPowerState Nicht implementiert. Informationen zum Implementieren dieser Methode finden Sie in der SetPowerState-Methode in CIM_LogicalDevice.

 

Eigenschaften

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

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)

Im Test (5)

Nicht zutreffend (6)

Ausschalten (7)

Offline (8)

Off Duty (9)

Beeinträchtigt (10)

Nicht installiert (11)

Installationsfehler (12)

Energiesparen – Unbekannt (13)

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

Energiesparen – Energiesparmodus (14)

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

Energiesparen – Standby ( 15)

Das Gerät funktioniert nicht, könnte aber schnell zur vollen Leistung gebracht werden.

Stromversorgung (16)

Energiesparen – Warnung (17)

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

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

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Kurze Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ClassGuid

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("WMI")

Globally Unique Identifier (GUID) dieses Plug & Play Geräts.

CompatibleID

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Eine vom Hersteller definierte Identifikationszeichenfolge, die Setup verwendet, um ein Gerät mit einer INF-Datei abzugleichen. Einem Gerät kann eine Liste kompatibler IDs zugeordnet sein. Die kompatiblen IDs sollten in der Reihenfolge der abnehmenden Eignung aufgeführt werden. Wenn Setup keine INF-Datei finden kann, die einer der Hardware-IDs eines Geräts entspricht, werden kompatible IDs verwendet, um nach einer INF-Datei zu suchen. Eine kompatible ID hat das gleiche Format wie eine HardwareID. Weitere Informationen finden Sie unter Windows Driver Kit.

ConfigManagerErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

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

Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

CreationClassName

Datentyp: string

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

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, Override ("DeviceId"), MappingStrings ("WMI")

Bezeichner des Plug & Play Geräts.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorCleared

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

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

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorDescription

Datentyp: string

Zugriffstyp: Schreibgeschützt

Weitere Informationen zu dem in LastErrorCode aufgezeichneten Fehler und Informationen zu eventuellen Korrekturmaßnahmen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

HardwareID

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Eine vom Anbieter definierte Identifikationszeichenfolge, die setup verwendet, um ein Gerät mit einer INF-Datei abzugleichen. Normalerweise verfügt ein Gerät über eine zugeordnete Liste von Hardware-IDs. Eine Ausnahme stellt der Bustreiber 1394 dar, der keine Hardware-IDs verwendet. Die erste Hardware-ID in der Liste sollte die Geräte-ID sein. Die verbleibenden IDs sollten in der Reihenfolge der abnehmenden Eignung aufgeführt werden.

Hardware-IDs werden in einem der folgenden Formate angezeigt:

  • enumerator\enumerator-specific-device-ID

    Dies ist das am häufigsten verwendete Format für einzelne PnP-Geräte. Ein Beispiel für einen Enumerator ist das BIOS oder ISAPNP.

  • *Enumeratorspezifische ID

    Ein Sternchen (*) gibt an, dass mehr als ein Enumerator verwendet wird.

  • geräteklassenspezifische ID

    Ein benutzerdefiniertes Format.

Beispiele für Hardware-IDs sind:

root\\\*PNPOF08
PC\\VEN\_1000&DEV\_001&SUBSYS\_0000000000&REV\_02

Weitere Informationen finden Sie im Windows Driver Kit.

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.

Manufacturer

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("WMI")

Name des Herstellers des Plug & Play Geräts.

Beispiel: "Acme"

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Name")

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

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PNP-Klasse

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("WMI")

Warnung

Diese Eigenschaft ist zwar in der MOF-Datei aufgeführt, aber in der -Klasse nicht vorhanden. Die Eigenschaft wird hier nur aus Gründen der Vollständigkeit und zur Klärung der MOF-Datei selbst beschrieben.

 

Der Name des Typs dieses Plug & Play Geräts.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 und Windows Vista: Diese Eigenschaft ist nicht in der MOF-Datei enthalten.

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

Nicht implementiert.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Unbekannt (0)

Die energiebezogenen Kapazitäten sind unbekannt.

Nicht unterstützt (1)

Energiebezogene Kapazitäten werden für dieses Gerät nicht unterstützt.

Deaktiviert (2)

Energiebezogene Kapazitäten wurden deaktiviert.

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 mit dem PowerState-Parameter aufgerufen werden, der 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 der Time-Parameter auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Einschalten festgelegt ist.

PowerManagementSupported

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Nicht implementiert.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Anwesend

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("WMI")

Gibt an, ob sich dieses Plug & Play Gerät derzeit im System befindet.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 und Windows Vista: Diese Eigenschaft wird nicht unterstützt.

Service

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("WMI")

Name des Diensts, der diese Plug & Play Gerät unterstützt. Weitere Informationen finden Sie unter Win32_SystemDriverPnPEntity.

Beispiel: "atapi"

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann beim Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

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.

Bemerkungen

Die Win32_PnPEntity-Klasse wird von CIM_LogicalDevice abgeleitet.

Beispiele

Das Get-BrokenHardware.ps1 PowerShell-Beispiels im TechNet-Katalog verwendet , um eine Liste der nicht funktionierenden Hardware mithilfe von WMI abzurufen Win32_PnPEntity.

Im folgenden VBScript-Codebeispiel wird eine Verbindung mit einer Gruppe von Remotecomputern in derselben Domäne hergestellt, indem ein Array von Remotecomputernamen erstellt und dann die Namen der Plug & Play Geräte ( Instanzen von Win32_PnPEntity ) auf jedem Computer angezeigt werden.

On Error Resume Next 
arrComputers = Array("Computer1","Computer2","Computer3")
For Each strComputer In arrComputers
    WScript.Echo
    WScript.Echo "===================================="
    WScript.Echo "Computer: "& strComputer
    WScript.Echo "===================================="

    Set objWMIService = GetObject("winmgmts:\\" _
        & strComputer& "\root\CIMV2") 
    Set colItems = objWMIService.ExecQuery( _
        "SELECT * FROM Win32_PnPEntity",,48) 
    For Each objItem in colItems 
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Win32_PnPEntity instance"
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Name: "& objItem.Name
        Wscript.Echo "Status: "& objItem.Status
    Next
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_LogicalDevice

Hardwareklassen des Computersystems

Herstellen einer Verbindung mit WMI auf einem Remotecomputer

WMI-Aufgaben: Computerhardware