Die Klasse "Win32_USBHub" stellt die Verwaltungseigenschaften eines USB-Hubs dar.
Unterstützung
Nicht unterstützt auf
Windows 2000
Unterstützt auf Windows XP , Windows Server 2003
Namespace
Die Klasse Win32_USBHub stammt aus dem WMI-Namensraum root\cimv2Methoden
Die Klasse Win32_USBHub stellt die folgenden Methoden zur Verfügung:| Methoden | Beschreibung |
|---|---|
| GetDescriptor | Nicht unterstützt auf: Windows 2000 |
| Reset | Nicht unterstützt auf: Windows 2000 |
| SetPowerState | Nicht unterstützt auf: Windows 2000 |
Eigenschaften
Die Klasse Win32_USBHub enthält die folgenden Eigenschaften:| Availability | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint16 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Verfügbarkeit und der Status des Geräts. Die Eigenschaft "Availability" gibt z. B. an, dass das Gerät aktiv ist und sich nicht im Energiesparmodus (Wert=3) befindet. Die Energiesparmodi sind wie folgt definiert: Der Wert 13 ("Energiesparmodus - Unbekannt") gibt an, dass sich das Gerät im Energiesparmodus befindet, aber der genaue Status unbekannt ist; 14 ("Niedriger Energiestatus") gibt an, dass sich das Gerät im Energiesparmodus befindet, aber noch funktioniert und die Leistung verringert ist; 15 ("Standby") gibt an, dass das Gerät nicht funktioniert, aber schnell reaktiviert werden kann; 17 ("Warnung") gibt an, dass sich das Gerät sowohl in einem Warnungs- als auch in einem Energiesparmodus befindet. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Caption | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "Caption" gibt eine kurze Textbeschreibung (eine Zeile) des Objekts an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ClassCode | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt den USB-Klassencode an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ConfigManagerErrorCode | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint32 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Gibt den Fehlercode des Win32-Konfigurations-Managers an. Die folgenden Werte können zurückgegeben werden: 0 Dieses Gerät funktioniert ordnungsgemäß. 1 Das Gerät funktioniert einwandfrei. 2 Der Treiber für dieses Gerät konnte nicht geladen werden. 3 Der Treiber für dieses Gerät ist entweder beschädigt, oder es stehen nicht genügend Arbeitsspeicher oder andere Ressourcen zur Verfügung. 4 Dieses Gerät funktioniert nicht ordnungsgemäß. Eventuell ist einer der Treiber oder die Registrierung beschädigt. 5 Der Treiber für dieses Gerät erfordert eine Ressource, die Windows nicht verwalten kann. 6 Die Startkonfiguration dieses Geräts verursacht Konflikte mit anderen Geräten. 7 Filterung nicht möglich. 8 Das Treiberladegerät für dieses Gerät ist nicht vorhanden. 9 Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch angibt. 10 Das Gerät kann nicht gestartet werden. 11 Das Gerät ist fehlgeschlagen. 12 Dieses Gerät kann keine ausreichenden freien Ressourcen finden, die verwendet werden können. 13 Die Ressourcen des Geräts können nicht verifiziert werden. 14 Sie müssen den Computer neu starten, damit dieses Gerät ordnungsgemäß funktioniert. 15 Das Gerät funktioniert nicht richtig, da beim erneuten Auflisten möglicherweise ein Fehler aufgetreten ist. 16 Es konnten nicht alle Ressourcen identifiziert werden, die das Gerät verwendet. 17 Dieses Gerät fordert einen unbekannten Ressourcentyp an. 18 Die Treiber für dieses Gerät müssen erneut installiert werden. 19 Die Registrierung ist eventuell beschädigt. 20 Fehler beim Verwenden des VxD-Ladeprogramms. 21 Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Falls dies nicht funktioniert, finden Sie weitere Informationen in der Hardwaredokumentation. Das Gerät wird entfernt. 22 Das Gerät wurde deaktiviert. 23 Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Falls dies nicht funktioniert, finden Sie weitere Informationen in der Hardwaredokumentation. 24 Dieses Gerät ist entweder nicht vorhanden, funktioniert nicht ordnungsgemäß, oder es wurden nicht alle Treiber installiert. 25 Das Gerät wird eingerichtet. 26 Das Gerät wird eingerichtet. 27 Das Gerät hat keine gültige Protokollkonfiguration. 28 Die Treiber für dieses Gerät wurden nicht installiert. 29 Dieses Gerät funktioniert nicht ordnungsgemäß, da die Firmware des Geräts die erforderlichen Ressourcen nicht zur Verfügung stellt. 30 Dieses Gerät greift auf eine Interruptanforderung (IRQ) zu, die bereits von einem anderen Gerät verwendet wird. 31 Das Gerät funktioniert nicht ordnungsgemäß, da Windows die für das Gerät erforderlichen Treiber nicht laden kann. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ConfigManagerUserConfig | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: boolean Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Gibt an, ob das Gerät eine benutzerdefinierte Konfiguration verwendet. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| CreationClassName | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| "CreationClassName" gibt den Namen der Klasse oder Teilklasse an, die beim Erstellen einer Instanz verwendet wird. Wenn diese Eigenschaft mit anderen Schlüsseleigenschaften dieser Klasse verwendet wird, können alle Instanzen der Klasse und der Teilklassen eindeutig erkannt werden. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| CurrentAlternateSettings | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Ein Array von alternativen USB-Einstellungen für jede Schnittstelle in der aktuell ausgewählten Konfiguration (von der Eigenschaft "CurrentConfigValue" angezeigt). Dieses Array hat einen Eintrag für jede Schnittstelle in der Konfiguration. Falls die Eigenschaft "CurrentConfigValue" den Wert null hat (zeigt an, dass das Gerät nicht konfiguriert ist), ist das Array nicht definiert. Weitere Informationen über das Verarbeiten dieser Oktettzeichenfolge finden Sie in der USB-Spezifikation. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| CurrentConfigValue | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt die für dieses Gerät zurzeit ausgewählte Konfiguration an. Dieses Gerät ist nicht konfiguriert, falls dieser Wert gleich null ist. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "Description" gibt eine Textbeschreibung des Objekts an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DeviceID | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "DeviceID" ist eine Adresse oder ein anderes Erkennungsmerkmal, mit der der USB-Hub eindeutig identifiziert werden kann. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ErrorCleared | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: boolean Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "ErrorCleared" ist ein boolescher Wert, der angibt, dass der in der Eigenschaft "LastErrorCode" angezeigte Fehler behoben ist. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ErrorDescription | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die formfreie Zeichenfolge "ErrorDescription" enthält Informationen über den in der Eigenschaft "LastErrorCode" angezeigten Fehler und eventuelle Korrekturvorgänge. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| GangSwitched | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: boolean Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt an, ob die Stromzufuhr auf den Hubanschlüssen einzeln oder gemeinsam aktiviert wird. Falls dieser Wert FALSE ist, wird die Stromzufuhr für jeden Anschluss einzeln aktiviert. Wenn dieser Wert TRUE ist, wird die Stromzufuhr auf alle Anschlüssen des Hubs gleichzeitig aktiviert. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| InstallDate | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: datetime Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "InstallDate" gibt an, wann das Objekt installiert wurde. Wenn der Wert nicht angegeben ist, kann das Objekt trotzdem installiert sein. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| LastErrorCode | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint32 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| "LastErrorCode" gibt den letzten Fehlercode des logischen Geräts an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "Name" zeigt den USB-Hubnamen an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| NumberOfConfigs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Anzahl der Gerätekonfigurationen, die für dieses Gerät definiert wurden. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| NumberOfPorts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Anzahl der untergeordneten Anschlüssen auf dem Hub, einschließlich der im Silikon des Hubs eingebetteten Anschlüsse. Einzelne USB-Anschlüsse mit dem Hub werden mit der Assoziation "USBPortOnHub" assoziiert. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PNPDeviceID | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Gibt die Win32 Plug & Play-Gerätekennung des logischen Geräts an. Beispiel: *PNP030b | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PowerManagementCapabilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint16 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Gibt die Energie-spezifischen Funktionen des logischen Geräts an. Die Werte 0="Unbekannt", 1="Nicht unterstützt" und 2="Deaktiviert" können angegeben werden. Der Wert 3="Aktiviert" gibt an, dass die Energieverwaltungsfunktionen aktiviert sind, aber die exakte Funktion unbekannt ist oder die Informationen nicht verfügbar sind. "Automatische Energiesparmodi" (4) gibt an, dass ein Gerät seinen Energiestatus basierend auf dem Energieverbrauch oder anderen Kriterien ändern kann. "Energiestatus einstellbar" (5) gibt an, dass die Methode "SetPowerState" unterstützt wird. "Energiezyklus unterstützt" (6) gibt an, dass die Methode "SetPowerState" mit dem Parameter "PowerState" 5 ("Energiezyklus") ausgeführt werden kann. "Geplante Reaktivierung unterstützt" (7) gibt an, dass die Methode "SetPowerState" mit dem Parameter "PowerState" 5 ("Energiezyklus") und dem Parameter "Time" ausgeführt werden kann. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PowerManagementSupported | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: boolean Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Boolescher Wert, der angibt, dass das Gerät im Stromsparmodus verwaltet werden kann, z. B. dass es in den Stromsparmodus versetzt werden kann. Dieser Boolescher Wert zeigt nicht an, ob die Energiesparverwaltungs-Funktionen zurzeit aktiviert sind oder welche der Funktionen unterstützt werden. Verwenden Sie das Array "PowerManagementCapabilities", um diese Informationen anzuzeigen. Falls dieser Wert auf FALSE festgelegt ist, sollte der ganzzahlige Wert 1 für die Zeichenfolge "Not Supported" der einzige Eintrag im Array "PowerManagementCapabilities" sein. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ProtocolCode | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt den USB-Protokollcode an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Status | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Eigenschaft "Status" gibt den aktuellen Status des Objekts an. Es können betriebsbereite oder nicht betriebsbereite Zustände definiert werden. Betriebsbereite Zustände sind "OK", "Heruntergestuft" und "Künftiger Fehler". "Künftiger Fehler" gibt an, dass ein Element ordnungsgemäß funktioniert, aber in naher Zukunft ein Fehler auftreten wird. Ein Beispiel ist eine SMART-aktivierte Festplatte. Nicht betriebsbereite Zustände sind "Fehler", "Starten", "Beenden" und "Dienst". "Dienst" kann während des erneuten Spiegelns eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder einem anderen administrativen Vorgang zutreffen. Nicht alle Vorgänge sind online. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| StatusInfo | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint16 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Die Zeichenfolge "StatusInfo" gibt den Gerätestatus an: "Aktiviert" (Wert = 3), "Deaktiviert" (4), "Andere" (1) oder "Unbekannt" (2). Der Wert 5 ("Nicht anwendbar") wird verwendet, wenn diese Eigenschaft nicht auf das logische Gerät zutrifft. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SubclassCode | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint8 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt den USB-Teilklassencode an. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SystemCreationClassName | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Der Erstellungsklassenname des bereichsdefinierenden Systems. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SystemName | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: string Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Der Name des bereichsdefinierenden Systems. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| USBVersion | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Datentyp: integer/usint16 Zugriff: Read-only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Zeigt die aktuelle USB-Version an, die vom USB-Gerät unterstützt wird. Die Eigenschaft wird als eine binär-codierte Dezimalzahl (BCD) angezeigt, wobei ein Dezimaltrennzeichen zwischen der zweiten und dritten Ziffer angedeutet wird. Z. B. zeigt ein Wert von 0x201 an, dass Version 2.01 unterstützt wird. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bemerkungen
Die Klasse Win32_USBHub ist abgeleitet von den folgenden Klassen:
CIM_USBHub
CIM_USBDevice
CIM_LogicalDevice
CIM_LogicalElement
CIM_ManagedSystemElement
Beispiele
Das folgende Beispiel zeigt, wie alle Instanzen dieser Klasse aufgelistet und ihr Inhalt angezeigt werden kann.
[VBScript]
strServer = "."
Set objWMI = GetObject("winmgmts://" & strServer & "/root\cimv2")
Set objInstances = objWMI.InstancesOf("Win32_USBHub",48)
For Each objInstance in objInstances
WScript.Echo objInstance.getObjectText_
Next
In die Zwischenablage kopieren]Das folgende Beispiel zeigt, wie die Eigenschaften dieser Klasse einzeln ausgelesen und aufgelistet werden.
[VBScript]
strServer = "."
Set objWMI = GetObject("winmgmts://" & strServer & "/root\cimv2")
Set objInstances = objWMI.InstancesOf("Win32_USBHub",48)
On Error Resume Next
For Each objInstance in objInstances
With objInstance
WScript.Echo .Availability
WScript.Echo .Caption
WScript.Echo .ClassCode
WScript.Echo .ConfigManagerErrorCode
WScript.Echo .ConfigManagerUserConfig
WScript.Echo .CreationClassName
WScript.Echo Join(.CurrentAlternateSettings, ", ")
WScript.Echo .CurrentConfigValue
WScript.Echo .Description
WScript.Echo .DeviceID
WScript.Echo .ErrorCleared
WScript.Echo .ErrorDescription
WScript.Echo .GangSwitched
WScript.Echo .InstallDate
WScript.Echo .LastErrorCode
WScript.Echo .Name
WScript.Echo .NumberOfConfigs
WScript.Echo .NumberOfPorts
WScript.Echo .PNPDeviceID
WScript.Echo Join(.PowerManagementCapabilities, ", ")
WScript.Echo .PowerManagementSupported
WScript.Echo .ProtocolCode
WScript.Echo .Status
WScript.Echo .StatusInfo
WScript.Echo .SubclassCode
WScript.Echo .SystemCreationClassName
WScript.Echo .SystemName
WScript.Echo .USBVersion
End With
On Error Goto 0
Next
Weitere Informationen:
MSDN Dokumentation