Verwalten von Surface Docks 2 mit WMI

Artikel
04/07/2023
Gilt für:

Windows 10, Windows 11

Die Unterstützung der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) bietet eine Vielzahl von Diagnoseinformationen, mit denen IT-Administratoren die neueste Firmware, den aktuellen Richtlinienstatus und die zugehörigen Daten für Surface Dock 2- und Surface Thunderbolt 4 Dock-Geräte remote überwachen und verwalten können. Sie können WMI mit Windows PowerShell, System Center Operations Manager und anderen Tools verwenden. Weitere Informationen zu WMI finden Sie unter Arbeiten mit WMI.

Aktivieren der WMI-Unterstützung

Surface Thunderbolt 4 Dock

Wechseln Sie zu Surface Thunderbolt 4 Dock Firmware und Treiber , und laden Sie das entsprechende Paket herunter:

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi

Surface Pro (fünfte Generation und höher)
Surface Book (zweite Generation und höher)
Surface Go (alle Generationen)
Surface Laptop (alle Generationen)
Surface Laptop Go (alle Generationen)

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi

Surface Pro 9 mit 5G
Surface Pro X

Surface Dock 2

Wechseln Sie zu Surface Dock 2 Firmware und Treiber , und laden Sie das entsprechende Paket herunter:

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi

Surface Pro (fünfte Generation und höher)
Surface Book (zweite Generation und höher)
Surface Go (alle Generationen)
Surface Laptop (alle Generationen)
Surface Laptop Go (alle Generationen)

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi

Surface Pro 9 mit 5G
Surface Pro X

Verwenden von WMI mit Surface Dock

Die folgenden Anweisungen gelten für Surface Dock 2 und Surface Thunderbolt 4 Dock.

So listeen Sie alle Dockkomponenteninstanzen auf:

Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"

Um auf Beschreibungen der WMI-Klasseneigenschaft zuzugreifen, öffnen Sie eine Eingabeaufforderung, und geben Sie WMI-Befehle ein, wobei Property eine der in Tabelle 1 aufgeführten Eigenschaften ist.
```
 Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
```

Beispiel: Um auf die Beschreibung für die CIM-Eigenschaft (Version Common Information Model) zuzugreifen, geben Sie Folgendes ein:

(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value

Tabelle 1: Surface Dock WMI-Referenz

Eigenschaft	Typ	Erwartete Werte	Beschreibung
ComponentName	Zeichenfolge	Surface Thunderbolt 4 Dock "Mikrocontroller" "Thunderbolt 4 Controller" "USB-Hub" "Power Delivery Controller 1" "Power Delivery Controller 2" "Audiocodec" "Ethernet-Controller" "DockSerialNumber" (Länge: 14 – z. B. 0V3379X22463GH) Surface Dock 2 "Mikrocontroller" "USB Hub 1" "USB Hub 2" "Porthub anzeigen" "Power Delivery Controller" "Audiocodec" "Ethernet-Controller"	Die folgende Eigenschaft listet den spezifischen Namen der Gerätekomponente auf, der die zugehörigen CIM-Klassendaten (Common Information Model) entsprechen.
DeviceName	Zeichenfolge	"Surface Dock 1" "Surface Dock 2" "Microsoft Surface Thunderbolt 4 Dock"	Die folgende Eigenschaft enthält den Namen des Dockgeräts, zu dem die jeweilige Gerätekomponente gehört.
DockSerialNumber	Zeichenfolge	Eine zwölfstellige (12)-stellige Seriennummer, die nur numerische Werte enthält	Die folgende Eigenschaft zeichnet die Seriennummer des angeschlossenen Dockgeräts auf. Diese Seriennummer ist für jede Komponente genau gleich, da sie zum selben Dockgerät gehören. Als Referenz kann diese Seriennummer physisch auf der Unterseite des Surface Dock selbst gefunden werden.
ID	uint16	0, 1, 2, ..., 65535	Die folgende Eigenschaft ist eine eindeutige ID, die bei Null (0) beginnt und nach oben zählt. Diese Variable wird zum Nummerieren der aufgezählten WMI-Instanzen verwendet.
LastUpdateStatus	Zeichenfolge	"Erfolg" "PendingDockReattach" "Fehler"	Die folgende Eigenschaft enthält Details zum letzten versuchten CFU-status (Component Firmware Update) für die betreffende Gerätekomponente. Mögliche Werte sind: Success,Pending Dock Reattach undFailed. - Erfolg gibt an, dass zuvor angewendete neue Firmware erfolgreich angewendet wurde - Ausstehendes erneutes Anfügen des Docks gibt an, dass ein neues Update für die Gerätekomponente aussteht und der Benutzer den Surface-Anschluss des Docks trennen und wieder anfügen muss, um das neue Update anzuwenden. - Fehler gibt an, dass während des CFU-Prozesses ein möglicher legitimer Fehler aufgetreten ist oder das Peripheriegerät nicht in der erwarteten Version gestartet wurde. Im Fall eines Fehlers ist dies kein Hinweis darauf, dass das Gerät nicht funktioniert, sondern beim Versuch, das Gerät zu aktualisieren, etwas Fehlerhaftes aufgetreten ist. In diesem Fall wird die vorherige Firmware weiterhin ausgeführt.
PolicyState	Zeichenfolge	"Aktiviert" "Deaktiviert"	Die folgende Eigenschaft gibt die aktuelle Richtlinie für den Surface Enterprise Management Mode (SEMM) für die Gerätekomponente an. Mögliche Werte sind: Aktiviert und Deaktiviert. - Aktiviert gibt an, dass das SEMM-System dem Hostgerät erlaubt hat, auf die Gerätekomponente zuzugreifen und sie zu verwenden. - Deaktiviert gibt an, dass das SEMM-System nicht zugelassen und dadurch verhindert hat, dass der Hostcomputer auf die Gerätekomponente zugreifen und diese verwenden kann.
ProductId	String[]	Eine Liste von hexadezimalen Zeichenfolgen, die jeweils von "0x0000" bis "0xFFFF" reichen können	Die folgende Eigenschaft klassifiziert die Produkt-ID (PID) der Gerätekomponente. Es ist möglich, dass mehrere PID aufgeführt sind. Im Falle eines USB-Hubs werden beispielsweise sowohl Super-Speed-Geräte (SS) als auch Hochgeschwindigkeitsgeräte (HS) in einem einzigen "Hub" zusammengefasst. Daher werden zwei (2) PIDs in diesem Array aufgeführt.
ProvisionedState	boolean	True oder False	Die folgende Eigenschaft beschreibt den bereitgestellten Zustand des Surface Enterprise Management Mode (SEMM) des Surface Dock-Geräts. Der bereitgestellte Zustand ist für jede Komponente genau gleich, da sie zum selben Dockgerät gehören. Mögliche Werte: True oder False. Der Wert true gibt an, dass das Surface Dock-Gerät derzeit verwaltet wird, sodass die Portfunktionalität möglicherweise eingeschränkt ist. Weitere Informationen finden Sie im Eigenschaftenfeld "PolicyState". Der Wert false gibt an, dass das Surface Dock-Gerät derzeit nicht verwaltet wird und keine Featureeinschränkungen gelten.
Status	Zeichenfolge	"OK" "Getrennt" "Fehler" "Fehlt" "DeviceHandleInUse" "Deaktiviert" "NotSupportedByWmi"	Die folgende Eigenschaft beschreibt den Zustand der Dockverbindung mit dem Hostcomputer. Mögliche Werte sind: OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled und NotSupportedByWmi. - OK gibt an, dass das Gerät erfolgreich mit dem Hostcomputer verbunden wurde und keine Probleme vorhanden sind, was seine Funktionalität beeinträchtigen würde. - Getrennt gibt an, dass der Surface-Connector, der die Verbindung für alle Gerätekomponenten bereitstellt, derzeit nicht an den Hostcomputer angeschlossen ist. - Fehler weist auf ein potenzielles Problem mit dem Gerät instance hin, und die Geräteschnittstelle wurde wahrscheinlich mit einem gelben Ausrufezeichen im Geräte-Manager gekennzeichnet. Überprüfen Sie die StatusCode-Eigenschaft, um ausführlichere Informationen zum Typ des aufgetretenen Fehlers zu finden. - Fehlt gibt an, dass auf dem Hostcomputer erwartet wurde, dass das Gerät aufgezählt wurde, aber aus irgendeinem Grund nicht. Die StatusCode-Eigenschaft enthält den Wert 24, um auf diese fehlerhafte Situation hinzuweisen. - DeviceHandleInUse gibt an, dass derzeit ein anderer Prozess mit dem Gerät kommuniziert, der diesen WMI-Instanzanbieter (Windows Management Instrumentation) von seinen Kommunikationsanforderungen abbindet. Versuchen Sie erneut, Den WMI-Befehl auszuführen! - Deaktiviert gibt an, dass die aktuelle Richtlinie für den Surface Enterprise Management Mode (SEMM) nicht zulässig ist und dadurch verhindert hat, dass der Hostcomputer auf die Gerätekomponente zugreifen und diese verwenden kann. Weitere Informationen finden Sie im Eigenschaftenfeld PolicyState . - NotSupportedByWmi gibt an, dass das verbundene Dock derzeit von diesem WMI-Anbieter nicht unterstützt wird. Diese status wird für das Surface Dock 1 angezeigt, das derzeit von diesem WMI-Instanzanbieter nicht unterstützt wird.
Statuscode	uint32	Geräte-Manager Fehlercode, der von der CIM_LogicalDevice WMI-Klasse (in cimwin32.mof) abgerufen wurde	Die folgende Eigenschaft stellt den Geräte-Manager Fehlercode für die angegebene Dockkomponente bereit. Der Wert 0 (0) gibt an, dass die Dockkomponente ordnungsgemäß funktioniert. ein Wert größer als 0 (0) gibt ein Problem oder einen möglichen Fehler mit der Dockkomponente an. Da die Dockkomponente mit mehreren Geräteschnittstellen aufgezählt werden kann, ist es möglich, dass andere Geräte-Manager Fehlercodes vorhanden sind. Dieses Eigenschaftenfeld listet nur einen einzelnen Fehlercode auf, auch wenn mehrere verfügbar sind. Die Geräte-Manager bezeichnet das Gerät nur dann mit einem gelben Ausrufezeichen, wenn bestimmte Fehlercodes aufgetreten sind.
Vendorid	Zeichenfolge	Eine hexadezimale Zeichenfolge, die von "0x0000" bis "0xFFFF" reichen kann	Die folgende Eigenschaft weist die spezifische Anbieter-ID (VID) der Gerätekomponente auf.
Version	Zeichenfolge	Eine Versionszeichenfolge mit folgendem Format: "x.y.z", wobei x, y und z numerische Werte sind.	Die folgende Eigenschaft gibt die aktuelle Version der Firmware an, die derzeit auf der Gerätekomponente ausgeführt wird.