Управление док-станциями Surface с помощью WMI
Поддержка инструментария управления Windows (WMI) предоставляет широкий набор диагностических сведений, позволяющих ИТ-администраторам удаленно отслеживать последнее встроенное ПО, состояние политики и связанные данные для док-устройств Surface Dock 2 и Surface Thunderbolt 4 и управлять ими. WMI можно использовать с Windows PowerShell, System Center Operations Manager и другими средствами. Дополнительные сведения о WMI см. в разделе Работа с WMI.
Перейдите в раздел Встроенное ПО и драйверы док-станции Surface Thunderbolt 4 и скачайте соответствующий пакет:
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi
- Surface Pro (пятое поколение и более поздние версии)
- Surface Book (второе поколение и более поздние версии)
- Surface Go (все поколения)
- Ноутбук Surface (все поколения)
- Surface Laptop Go (все поколения)
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi
- Surface Pro 9 с 5G
- Surface Pro X
Перейдите в раздел Встроенное ПО и драйверы док-станции Surface 2 и скачайте соответствующий пакет:
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi
- Surface Pro (пятое поколение и более поздние версии)
- Surface Book (второе поколение и более поздние версии)
- Surface Go (все поколения)
- Ноутбук Surface (все поколения)
- Surface Laptop Go (все поколения)
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi
- Surface Pro 9 с 5G
- Surface Pro X
Следующие инструкции относятся к док-станции Surface 2 и док-станции Surface Thunderbolt 4.
Перечисление всех экземпляров компонентов док-станции:
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"
Чтобы получить доступ к описаниям свойств класса WMI, откройте командную строку и введите команды WMI, где Свойство является одним из свойств, перечисленных в таблице 1.
Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
Пример: Чтобы получить доступ к описанию свойства CIM , введите следующее:
(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value
Свойство | Тип | Ожидаемые значения | Описание |
---|---|---|---|
Имя компонента | Строка |
Док-станция Surface Thunderbolt 4 "Микроконтроллер" "Контроллер Thunderbolt 4" "USB-концентратор" "Контроллер доставки питания 1" "Контроллер доставки питания 2" "Аудиокодек" "Контроллер Ethernet" DockSerialNumber (длина: 14 — например, 0V3379X22463GH) Док-станция Surface 2 "Микроконтроллер" "USB-концентратор 1" "USB-концентратор 2" "Display Port Hub" "Контроллер доставки питания" "Аудиокодек" "Контроллер Ethernet" |
Следующее свойство содержит конкретное имя компонента устройства, которому соответствуют соответствующие данные класса Common Information Model (CIM). |
DeviceName | Строка | "Док-станция Surface 1" "Док-станция Surface 2" "Док-станция Microsoft Surface Thunderbolt 4" |
Следующее свойство содержит имя док-устройства, которому принадлежит определенный компонент устройства. |
DockSerialNumber | Строка | 12-значный серийный номер, содержащий только числовые значения. | Следующее свойство записывает серийный номер подключенного док-устройства. Этот серийный номер является одинаковым для каждого компонента, так как они принадлежат одному и тому же док-устройству. Для справки этот серийный номер можно физически найти на нижней стороне самой док-станции Surface. |
Id | uint16 | 0, 1, 2, ..., 65535 | Следующее свойство является уникальным идентификатором, начинающимся с нуля (0) и отсчитывающим вверх. Эта переменная используется для нумеровки перечисляемых экземпляров WMI. |
LastUpdateStatus | Строка | "Успех" PendingDockReattach "Сбой" |
В следующем свойстве описывается состояние последней попытки обновления встроенного ПО компонента (CFU) для соответствующего компонента устройства. Возможные значения: Success,Pending Dock Reattach иFailed. - Успешное применение означает, что ранее примененное новое встроенное ПО было успешно применено. - Ожидание повторного подключения док-станции означает, что ожидается новое обновление для компонента устройства, и пользователь должен отсоединить и повторно подключить соединитель Surface док-станции, чтобы применить новое обновление. - Сбой означает, что во время процесса CFU произошла возможная ошибка или периферийное устройство не загрузилось в ожидаемой версии. В случае сбоя это не указывает на то, что устройство не работает, а что-то ошибочное произошло при попытке обновить устройство. В этом случае предыдущее встроенное ПО продолжает работать. |
PolicyState | Строка | "Включено" "Отключено" |
Следующее свойство указывает текущую политику режима управления Surface Enterprise (SEMM) для компонента устройства. Возможные значения: Включено и Отключено. - Включено указывает, что система SEMM разрешила хост-устройству доступ к компоненту устройства и его использование. - Отключено означает, что система SEMM запретила доступ к компоненту устройства и тем самым предотвратила доступ к компоненту устройства. |
ProductId | String[] | Список шестнадцатеричных строк, каждая из которых может варьироваться от "0x0000" до "0xFFFF". | Следующее свойство классифицирует идентификатор продукта (PID) компонента устройства. Возможно, в списке может быть несколько PID. Например, в случае с USB-концентратором устройства super Speed (SS) и High Speed (HS) объединяются в единый "концентратор". Таким образом, два (2) PID будут перечислены в этом массиве. |
ProvisionedState | логический | True или False | В следующем свойстве описывается состояние подготовленного режима управления Surface Enterprise (SEMM) устройства док-станции Surface. Подготовленное состояние одинаково для каждого компонента, так как они принадлежат одному и тому же док-устройству. Возможные значения: True или False. Значение true указывает, что устройством док-станции Surface в настоящее время управляется, поэтому функциональность порта может быть ограничена. Дополнительные сведения см. в поле свойства PolicyState. Значение false указывает, что устройство док-станции Surface в настоящее время не управляется и не имеет ограничений на функции. |
Состояние | Строка | "ОК" "Отключено" "Ошибка" "Отсутствует" DeviceHandleInUse "Отключено" NotSupportedByWmi |
Следующее свойство описывает состояние подключения док-станции к хост-компьютеру. Возможные значения: OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled и NotSupportedByWmi. - ОК указывает, что устройство успешно подключено к хост-компьютеру и не существует проблем, что помешать его функциональности - Отключено означает, что соединитель Surface, который обеспечивает подключение для всех компонентов устройства, в настоящее время не подключен к хост-компьютеру. - Ошибка указывает на потенциальную проблему с экземпляром устройства, и интерфейс устройства, скорее всего, помечен желтым восклицательным знаком в диспетчере устройств. Проверьте свойство StatusCode для получения более подробных сведений о типе возникших ошибок. - Отсутствует означает, что устройство должно было перечислить на хост-компьютере, но по какой-то причине этого не произошло. Свойство StatusCode будет содержать значение 24, чтобы указать на эту ошибочную ситуацию. - DeviceHandleInUse указывает, что другой процесс в настоящее время взаимодействует с устройством, что запрещает этому поставщику экземпляров инструментария управления Windows (WMI) от запросов на обмен данными. Попробуйте выполнить команду WMI еще раз! - Отключено означает, что текущая политика режима управления Surface Enterprise (SEMM) запретила доступ к компоненту устройства и тем самым предотвратила доступ к компоненту устройства. Дополнительные сведения см. в поле свойства PolicyState . - NotSupportedByWmi указывает, что подключенная док-станция в настоящее время не поддерживается этим поставщиком WMI. Это состояние отображается для док-станции Surface 1, которая в настоящее время не поддерживается этим поставщиком экземпляров WMI. |
StatusCode | uint32 | Код ошибки диспетчера устройств , полученный из класса WMI CIM_LogicalDevice (в cimwin32.mof) | Следующее свойство предоставляет код ошибки диспетчера устройств для заданного компонента док-станции. Нулевое значение (0) указывает, что компонент док-станции работает правильно; Значение больше нуля (0) указывает на проблему или возможную ошибку с компонентом док-станции. Поскольку компонент док-станции может перечисляться с несколькими интерфейсами устройств, возможно, существуют и другие коды ошибок диспетчера устройств. В этом поле свойства отображается только один код ошибки, даже если доступно несколько. Диспетчер устройств помечает устройство желтым восклицательным знаком только при возникновении определенных кодов ошибок. |
VendorId | Строка | Шестнадцатеричная строка, которая может варьироваться от "0x0000" до "0xFFFF". | В следующем свойстве отмечается конкретный идентификатор поставщика (VID) компонента устройства. |
Версия | Строка | Строка версии, которая имеет следующий вид: "x.y.z", где x, y и z являются числовыми значениями. | Следующее свойство указывает текущую версию встроенного ПО, которая в настоящее время выполняется на компоненте устройства. |