使用 WMI 管理 Surface Docks

  • 项目
  • 适用于:
    Windows 10, Windows 11

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。

  1. 枚举所有停靠组件实例：

    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 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 类 (获取的设备管理器错误代码 以下属性提供给定扩展坞组件的 Device Manager 错误代码。 值为 0 (0) 表示停靠组件正常工作;大于零的值 (0) 表示扩展坞组件存在问题或可能的错误。 由于扩展坞组件可能枚举多个设备接口，因此可能存在其他 Device Manager 错误代码。 此属性字段仅列出单个错误代码，即使有多个错误代码可用。 仅当出现某些错误代码时，设备管理器才使用黄色感叹号标记设备。
VendorId 字符串 范围从“0x0000”到“0xFFFF”的十六进制字符串 以下属性记录设备组件的特定供应商 ID (VID) 。
版本 字符串 版本字符串，其格式如下：“x.y.z”，其中 x、y 和 z 是数值。 以下属性指定当前在设备组件上运行的固件的当前版本。

了解详细信息