共用方式為

使用 WMI 管理 Surface Dock

  • 發行項
  • 適用於:
    Windows 10, Windows 11

Windows Management Instrumentation (WMI) 支援提供一組豐富的診斷資訊，可讓 IT 系統管理員從遠端監視及管理 Surface 擴充座 2 和 Surface 要點 4 擴充座裝置的最新韌體、原則狀態和相關數據。 您可以使用 WMI 搭配 Windows PowerShell、System Center Operations Manager 和其他工具。 如需 WMI 的詳細資訊，請 參閱使用 WMI。

啟用 WMI 支援

SurfaceBolt 4 擴充座

請移至 SurfaceBolt 4 擴充座韌體和驅動程式 ，並下載適當的套件：

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi

  • Surface Pro (第五代和更新版本)
  • Surface Book (第二代和更新版本)
  • Surface Go (所有層代)
  • Surface Laptop (所有世代)
  • Surface Laptop Go (所有世代)

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi

  • Surface Pro 9 搭配 5G
  • Surface Pro X

Surface 擴充座 2

移至 Surface 擴充座 2 韌體和驅動程式 ，並下載適當的套件：

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi

  • Surface Pro (第五代和更新版本)
  • Surface Book (第二代和更新版本)
  • Surface Go (所有層代)
  • Surface Laptop (所有世代)
  • Surface Laptop Go (所有世代)

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi

  • Surface Pro 9 搭配 5G
  • Surface Pro X

搭配 Surface 擴充座使用 WMI

下列指示適用於 Surface 擴充座 2 和 Surface SurfaceBolt 4 擴充座。

  1. 若要列舉所有 Dock 元件實例：

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

  2. 若要存取 WMI 類別屬性描述，請開啟命令提示字元並輸入 WMI 命令，其中 Property 是表格 1 中所列的其中一個屬性。

     Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]

  • 例： 若要存取 CIM) 屬性 (版本 通用資訊模型的描述，請輸入下列內容：

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

表 1. Surface 擴充座 WMI 參考

屬性 類型 預期值 (的) 描述
ComponentName 字串 SurfaceBolt 4 擴充座

“Microcontroller”
“電閥 4 控制器”
“USB 中樞”
“電源傳遞控制器 1”
“電源傳遞控制器 2”
“音訊編解碼器”
“以太網络控制器”

“DockSerialNumber”
(長度：14 - 例如，0V3379X22463GH)

Surface 擴充座 2
“Microcontroller”
“USB Hub 1”
“USB Hub 2”
「顯示埠中樞」
「電源傳遞控制器」
“音訊編解碼器”
“以太網络控制器”		 下列屬性列出隨附的通用資訊模型 (CIM) 類別數據對應的裝置元件特定名稱。
DeviceName 字串 “Surface Dock 1”
“Surface Dock 2”
“Microsoft SurfaceBolt 4 擴充座”		 下列屬性包含特定裝置元件所屬的擴充裝置名稱。
DockSerialNumber 字串 十二 (12) 只包含數值的數位序號 下列屬性會記錄附加的擴充裝置序號。 每個元件的序號都完全相同，因為它們屬於相同的 Dock 裝置。 如需參考，您可以在 Surface 擴充座本身的底端實際找到此序號。
Id uint16 0, 1, 2, ..., 65535 下列屬性是唯一的標識碼，從零 (0 開始) 並計算。 此變數用於編號列舉的 WMI 實例。
LastUpdateStatus 字串 “Success”
“PendingDockReattach”
“Failed”		 下列屬性詳述上次嘗試的元件韌體更新 (CFU) 裝置元件的狀態。 可能的值為： Success、Pending Dock Reattach 和 Failed。


- 成功 表示先前套用的新韌體已成功套用
- Pending Dock Reattach 表示裝置元件有新的更新擱置中，用戶必須卸離並重新附加擴充座的 Surface 連接器，才能套用新的更新。
- 失敗 表示 CFU 程式期間可能發生合法的錯誤，或周邊未在預期的版本中開機。 在 [失敗 ] 案例中，這不是裝置無法運作的指示，而是嘗試更新裝置時發生錯誤的情況。 在這種情況下，先前的韌體會繼續執行。
PolicyState 字串 “Enabled”
“Disabled”		 下列屬性指出裝置元件的目前 Surface Enterprise 管理模式 (SEMM) 原則。 可能的值為： Enabled 和 Disabled。


- 已啟用 表示 SEMM 系統已允許主機裝置存取和使用裝置元件
- [停用 ] 表示 SEMM 系統不允許，因此無法讓主計算機存取和使用裝置元件。
ProductId String[] 十六進位字串清單，每個字串的範圍從 “0x0000” 到 “0xFFFF” 下列屬性會將裝置元件的產品標識碼 (PID) 分類。 可能會列出一個以上的 PID。 例如，在 USB 中樞的情況下，超高速 (SS) 和高速 (HS) 裝置都會被分成單一的「中樞」。因此，此陣列出兩個 (2) PIN。
ProvisionedState 布林值 True 或 False 下列屬性描述 Surface 擴充座裝置) 布建狀態 (SEMM 的 Surface Enterprise 管理模式。 每個元件的布建狀態都完全相同，因為它們屬於相同的 Dock 裝置。 可能的值為：True 或 False。 值為 true 表示 Surface 擴充座裝置目前受到管理，因此可能會限制埠功能。 如需詳細資訊，請參閱 「PolicyState」 屬性欄位。 值為 false 表示 Surface 擴充座裝置目前未受管理，而且沒有強制執行任何功能限制。
狀態 字串 “OK”
“Disconnected”
“錯誤”
“Missing”
“DeviceHandleInUse”
“Disabled”
“NotSupportedByWmi”		 下列屬性描述 Dock 與主計算機的連線狀態。 可能的值為： OK、Disconnected、Error、Missing、DeviceHandleInUse、Disabled 和 NotSupportedByWmi。
- [確定 ] 表示裝置已成功連線到主計算機，而且沒有任何問題存在，這會妨礙其功能
- 已中斷 連線，表示提供所有裝置元件連線的 Surface 連接器目前未連結至主電腦。
- 錯誤表示裝置實例的潛在問題，而且裝置介面很可能在 裝置管理員 中標示黃色驚嘆號 – 請檢查 StatusCode 屬性，以取得所發生錯誤類型的詳細資訊。
- 遺失 表示裝置預期已列舉在主計算機上，但基於某些原因並未列舉。 StatusCode 屬性會保留 24 的值，以指出這個錯誤的情況。
- DeviceHandleInUse 指出另一個進程目前正在與裝置通訊，這會禁止此 Windows Management Instrumentation (WMI) 實例提供者的通訊要求。 請嘗試再次執行您的 WMI 命令！
- [停用 ] 表示目前 Surface Enterprise 管理模式 (SEMM) 原則已不允許，因此無法讓主計算機存取和使用裝置元件。 如需詳細資訊，請參閱 PolicyState 屬性欄位。
- NotSupportedByWmi 表示此 WMI 提供者目前不支持連線的擴充座。 Surface 擴充座 1 會出現此狀態，此 WMI 實例提供者目前不支援此狀態。
StatusCode uint32 裝置管理員 從 cimwin32.mof 內的 CIM_LogicalDevice WMI 類別 (取得的錯誤碼) 下列屬性提供指定停駐元件的 裝置管理員 錯誤碼。 值為零 (0) 表示擴充元件正常運作;大於零 (0 的值) 表示停駐元件發生問題或可能的錯誤。 因為 Dock 元件可能會列舉數個裝置介面，所以可能會有其他 裝置管理員 錯誤碼。 這個屬性欄位只會列出單一錯誤碼，即使有多個錯誤碼可供使用。 只有在發生特定錯誤碼時，裝置管理員 才會以黃色驚嘆號為裝置加上標籤。
VendorId 字串 可從 「0x0000」 到 「0xFFFF」 的十六進位字串 下列屬性會記下裝置元件的特定廠商標識碼 (VID) 。
版本 字串 版本字串，其格式如下：「x.y.z」，其中 x、y 和 z 是數值。 下列屬性會指定目前在裝置元件上執行的韌體目前版本。

深入了解