使用 WMI 管理 Surface Dock
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 擴充座。
若要列舉所有 Dock 元件實例:
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"
若要存取 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 是數值。 | 下列屬性會指定目前在裝置元件上執行的韌體目前版本。 |