Прочитать на английском

Поделиться через


Управление док-станциями Surface с помощью WMI

Поддержка инструментария управления Windows (WMI) предоставляет широкий набор диагностических сведений, позволяющих ИТ-администраторам удаленно отслеживать последнее встроенное ПО, состояние политики и связанные данные для док-устройств Surface Dock 2 и Surface Thunderbolt 4 и управлять ими. 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 (все поколения)
  • 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 (все поколения)
  • Surface Laptop Go (все поколения)

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi

  • Surface Pro 9 с 5G
  • Surface Pro X

Использование WMI с док-станцией Surface

Следующие инструкции относятся к док-станции Surface 2 и док-станции Surface Thunderbolt 4.

  1. Перечисление всех экземпляров компонентов док-станции:

    Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent" 
    
  2. Чтобы получить доступ к описаниям свойств класса 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
    

Таблица 1: Справочник по WMI док-станции Surface

Свойство Тип Ожидаемые значения Описание
Имя компонента Строка Док-станция 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 являются числовыми значениями. Следующее свойство указывает текущую версию встроенного ПО, которая в настоящее время выполняется на компоненте устройства.

Подробнее