使用 WMI 管理 Surface Docks
Windows Management Instrumentation (WMI) 支持提供了一组丰富的诊断信息，使 IT 管理员能够远程监视和管理 Surface Dock 2 和 Surface Thunderbolt 4 Dock 设备的最新固件、策略状态和相关数据。 可以将 WMI 与 Windows PowerShell、System Center Operations Manager 和其他工具配合使用。 有关 WMI 的详细信息，请参阅 使用 WMI。
启用 WMI 支持
Surface Thunderbolt 4 扩展坞
转到 Surface Thunderbolt 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
- 5G Surface Pro 9
- Surface Pro X
Surface Dock 2
转到 Surface Dock 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
- 5G Surface Pro 9
- Surface Pro X
将 WMI 与 Surface Dock 配合使用
以下说明适用于 Surface Dock 2 和 Surface Thunderbolt 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 Dock WMI 参考
| 属性 | 类型 | 预期值 () | 描述 |
|---|---|---|---|
| ComponentName | 字符串 |
Surface Thunderbolt 4 扩展坞 “微控制器” “Thunderbolt 4 控制器” “USB 集线器” “电源传送控制器 1” “电源传送控制器 2” “音频编解码器” “以太网控制器” “DockSerialNumber” (长度：14 - 例如，0V3379X22463GH) Surface Dock 2 “微控制器” “USB Hub 1” “USB Hub 2” “显示端口中心” “电源传送控制器” “音频编解码器” “以太网控制器” |
以下属性列出了公共信息模型 (C) IM 类数据所对应的设备组件的特定名称。 |
| DeviceName | 字符串 | “Surface Dock 1” “Surface Dock 2” “Microsoft Surface Thunderbolt 4 扩展坞” |
以下属性包含特定设备组件所属的停靠设备的名称。 |
| DockSerialNumber | 字符串 | 仅包含数值的 12 (12) 位序列号 | 以下属性记录附加的扩展坞设备的序列号。 对于每个组件，此序列号完全相同，因为它们属于同一扩展坞设备。 为了参考，此序列号可以在 Surface 扩展坞本身的底部以物理方式找到。 |
| ID | uint16 | 0, 1, 2, ..., 65535 | 以下属性是一个唯一 ID，从零开始 (0) 并计数。 此变量用于对枚举的 WMI 实例进行编号。 |
| LastUpdateStatus | 字符串 | “成功” “PendingDockReattach” “失败” |
以下属性详细说明了上次尝试的组件固件更新 (CFU) 有关设备组件的状态。 可能的值包括： Success、Pending Dock Reattach 和 Failed。 - 成功 表示已成功应用以前应用的新固件 - 挂起的 Dock 重新附加 指示设备组件有新的更新挂起，用户必须分离并重新附加 Dock 的 Surface 连接器才能应用新的更新。 - 失败 表示在 CFU 过程中可能发生了合法错误，或者外围设备未在预期版本中启动。 在 失败 的情况下，这不是设备无法正常工作的指示，而是在尝试更新设备时发生了错误的情况。 在这种情况下，以前的固件将继续运行。 |
| PolicyState | 字符串 | “已启用” “Disabled” |
以下属性指示设备组件的当前 Surface Enterprise Management Mode (SEMM) 策略。 可能的值为： Enabled 和 Disabled。 - Enabled 表示 SEMM 系统已允许主机设备访问和使用设备组件 - Disabled 表示已禁止 SEMM 系统，从而阻止主机访问和使用设备组件。 |
| ProductId | String[] | 十六进制字符串的列表，每个字符串的范围都可以从“0x0000”到“0xFFFF” | 以下属性对设备组件的产品 ID (PID) 进行分类。 可能会列出多个 PID。 例如，对于 USB 集线器，超高速 (SS) 和高速 (HS) 设备都合并为一个单一的“集线器”。因此，此数组中将列出两个 (2) PID。 |
| ProvisionedState | 布尔型 | True 或 False | 以下属性描述了 Surface Enterprise Management Mode (SEMM) Surface Dock 设备的预配状态。 每个组件的预配状态完全相同，因为它们属于同一扩展坞设备。 可能的值为：True 或 False。 值为 true 表示 Surface Dock 设备当前处于托管状态，因此端口功能可能会受到限制。 有关详细信息，请参阅“PolicyState”属性字段。 值为 false 表示 Surface Dock 设备当前不受管理，并且没有施加功能限制。 |
| 状态 | 字符串 | “确定” “Disconnected” “错误” “Missing” “DeviceHandleInUse” “Disabled” “NotSupportedByWmi” |
以下属性描述 Dock 与主机的连接状态。 可能的值包括： OK、Disconnected、Error、Missing、DeviceHandleInUse、Disabled 和 NotSupportedByWmi。 - 正常 表示设备已成功连接到主机，并且不存在问题，这将阻止其功能 - 断开连接 表示 Surface 连接器（为所有设备组件提供连接）当前未连接到主机。 - 错误指示设备实例的潜在问题，并且设备接口很可能在设备管理器中标有黄色感叹号 - 检查 StatusCode 属性，了解有关所发生错误类型的详细信息。 - 缺少 表示设备预期已在主机上枚举，但出于某种原因未枚举。 StatusCode 属性将保留值 24 以指示此错误情况。 - DeviceHandleInUse 指示另一个进程当前正在与设备通信，这将禁止此 Windows Management Instrumentation (WMI) 实例提供程序的通信请求。 再次尝试执行 WMI 命令！ - Disabled 表示当前 Surface Enterprise Management Mode (SEMM) 策略已禁止，从而阻止主机访问和使用设备组件。 有关详细信息，请参阅 PolicyState 属性字段。 - NotSupportedByWmi 指示此 WMI 提供程序当前不支持连接的扩展坞。 此 WMI 实例提供程序当前不支持的 Surface Dock 1 将显示此状态。 |
| StatusCode | uint32 | 设备管理器从 cimwin32.mof) 中的 CIM_LogicalDevice WMI 类 (获取的错误代码 | 以下属性提供给定扩展坞组件的设备管理器错误代码。 值为 0 (0) 表示停靠组件正常工作;大于零的值 (0) 表示扩展坞组件存在问题或可能的错误。 由于扩展坞组件可能枚举多个设备接口，因此可能存在其他设备管理器错误代码。 此属性字段仅列出单个错误代码，即使有多个错误代码可用。 仅当出现某些错误代码时，设备管理器才使用黄色感叹号标记设备。 |
| VendorId | 字符串 | 范围从“0x0000”到“0xFFFF”的十六进制字符串 | 以下属性记录设备组件的特定供应商 ID (VID) 。 |
| 版本 | 字符串 | 版本字符串，其格式如下：“x.y.z”，其中 x、y 和 z 是数值。 | 以下属性指定当前在设备组件上运行的固件的当前版本。 |