Auf Englisch lesen

Freigeben über


Verwalten von Surface Docks 2 mit WMI

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.

  1. So listeen Sie alle Dockkomponenteninstanzen auf:

    Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent" 
    
  2. 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 beschreibt den 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 der Geräteinstanz 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 Aufgetretenen Fehlertyp 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. Dieser 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. Der Geräte-Manager kennzeichnet 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.

Weitere Informationen