Compartir a través de

Administrar Surface Dock con WMI

  • Artículo
  • Se aplica a:
    Windows 10, Windows 11

La compatibilidad con Instrumental de administración de Windows (WMI) proporciona un amplio conjunto de información de diagnóstico que permite a los administradores de TI supervisar y administrar de forma remota el firmware, el estado de directiva y los datos relacionados más recientes para los dispositivos Surface Dock 2 y Surface Thunderbolt 4 Dock. Puede usar WMI con Windows PowerShell, System Center Operations Manager y otras herramientas. Para obtener más información sobre WMI, vea Trabajar con WMI.

Habilitación de la compatibilidad con WMI

Surface Thunderbolt 4 Dock

Ve a Surface Thunderbolt 4 Dock Firmware and Drivers y descarga el paquete adecuado:

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi

  • Surface Pro (quinta generación y versiones posteriores)
  • Surface Book (segunda generación y versiones posteriores)
  • Surface Go (todas las generaciones)
  • Surface Laptop (todas las generaciones)
  • Surface Laptop Go (todas las generaciones)

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi

  • Surface Pro 9 con 5G
  • Surface Pro X

Surface Dock 2

Vaya a Firmware y controladores de Surface Dock 2 y descargue el paquete adecuado:

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi

  • Surface Pro (quinta generación y versiones posteriores)
  • Surface Book (segunda generación y versiones posteriores)
  • Surface Go (todas las generaciones)
  • Surface Laptop (todas las generaciones)
  • Surface Laptop Go (todas las generaciones)

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi

  • Surface Pro 9 con 5G
  • Surface Pro X

Uso de WMI con Surface Dock

Las siguientes instrucciones se aplican a Surface Dock 2 y Surface Thunderbolt 4 Dock.

  1. Para enumerar todas las instancias de componentes de acoplamiento:

    Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"

  2. Para acceder a las descripciones de la propiedad de clase WMI, abra un símbolo del sistema y escriba comandos WMI donde Propiedad es una de las propiedades enumeradas en la tabla 1.

     Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]

  • Ejemplo: Para acceder a la descripción de la propiedad Modelo de información común de versión (CIM), escriba lo siguiente:

    (Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value

Tabla 1. Referencia de WMI de Surface Dock

Propiedad Tipo Valores esperados Descripción
ComponentName Cadena Surface Thunderbolt 4 Dock

"Microcontrolador"
"Controlador Thunderbolt 4"
"Concentrador USB"
"Controlador de entrega de energía 1"
"Controlador de entrega de energía 2"
"Códec de audio"
"Controlador Ethernet"

"DockSerialNumber"
(longitud: 14 - Por ejemplo, 0V3379X22463GH)

Surface Dock 2
"Microcontrolador"
"Usb Hub 1"
"Usb Hub 2"
"Display Port Hub"
"Controlador de entrega de energía"
"Códec de audio"
"Controlador Ethernet"		 En la propiedad siguiente se muestra el nombre específico del componente de dispositivo al que corresponden los datos de clase de Common Information Model (CIM) correspondientes.
Propiedad DeviceName Cadena "Surface Dock 1"
"Surface Dock 2"
"Base de Microsoft Surface Thunderbolt 4"		 La siguiente propiedad contiene el nombre del dispositivo de acoplamiento al que pertenece el componente de dispositivo específico.
DockSerialNumber Cadena Número de serie de doce (12) dígitos que contiene solo valores numéricos La siguiente propiedad registra el número de serie del dispositivo acoplado conectado. Este número de serie es exactamente el mismo para cada componente, ya que pertenecen al mismo dispositivo acoplado. Como referencia, este número de serie se puede encontrar físicamente en la parte inferior de surface dock.
Id uint16 0, 1, 2, ..., 65535 La siguiente propiedad es un identificador único que comienza desde cero (0) y cuenta. Esta variable se usa para numerar las instancias de WMI enumeradas.
LastUpdateStatus Cadena "Éxito"
"PendingDockReattach"
"Error"		 En la propiedad siguiente se detalla el último intento de actualización de firmware de componentes (CFU) para el componente de dispositivo en cuestión. Los valores posibles son: Success,PendingDock Reattach y Failed.


- Correcto indica que el nuevo firmware aplicado anteriormente se aplicó correctamente
- Pendiente Desasociación de acoplamiento indica que hay una nueva actualización pendiente para el componente de dispositivo y que el usuario debe desasociar y volver a conectar el conector Surface del dock para aplicar la nueva actualización.
- Error indica que se ha producido un posible error legítimo durante el proceso de CFU o que el periférico no se ha arrancado en la versión esperada. En el caso de error , esto no es una indicación de que el dispositivo no funciona, sino que se produjo algo erróneo al intentar actualizar el dispositivo. En tal caso, el firmware anterior continúa ejecutándose.
PolicyState Cadena "Habilitado"
"Deshabilitado"		 La siguiente propiedad indica la directiva actual del Modo de administración empresarial (SEMM) de Surface para el componente de dispositivo. Los valores posibles son: Habilitado y Deshabilitado.


- Habilitado indica que el sistema SEMM ha permitido que el dispositivo host acceda al componente de dispositivo y lo use.
- Deshabilitado indica que el sistema SEMM no se ha permitido y, por tanto, ha impedido que la máquina host acceda al componente del dispositivo y lo use.
ProductId Cadena[] Una lista de cadenas hexadecimales, que pueden oscilar entre "0x0000" y "0xFFFF" La siguiente propiedad clasifica el id. de producto (PID) del componente de dispositivo. Es posible que haya más de un PID en la lista. En el caso de un concentrador USB, por ejemplo, tanto los dispositivos supervelocidad (SS) como los de alta velocidad (HS) se agrupan en un singular "Hub". Por lo tanto, se enumeran dos (2) PID dentro de esta matriz.
ProvisionedState booleano True o False En la siguiente propiedad se describe el estado aprovisionado del Modo de administración empresarial (SEMM) de Surface del dispositivo Surface Dock. El estado aprovisionado es exactamente el mismo para cada componente, ya que pertenecen al mismo dispositivo de acoplamiento. Los valores posibles son: True o False. Un valor de true indica que el dispositivo Surface Dock está administrado actualmente y, por tanto, la funcionalidad del puerto puede estar restringida. Para obtener más información, consulte el campo de propiedad "PolicyState". Un valor de false indica que el dispositivo Surface Dock no está administrado y no tiene restricciones de características impuestas.
Estado Cadena "Muy bien"
"Desconectado"
"Error"
"Falta"
"DeviceHandleInUse"
"Deshabilitado"
"NotSupportedByWmi"		 En la siguiente propiedad se describe el estado de la conexión del dock a la máquina host. Los valores posibles son: Ok,Disconnected,Error,Missing,DeviceHandleInUse,Disabled y NotSupportedByWmi.
- Aceptar indica que el dispositivo está conectado correctamente a la máquina host y no existen problemas, lo que inhibiría su funcionalidad.
- Desconectado indica que el conector de Surface, que proporciona la conexión para todos los componentes del dispositivo, no está conectado actualmente a la máquina host.
- El error indica un posible problema con la instancia del dispositivo y es más probable que la interfaz del dispositivo se haya etiquetado con un signo de exclamación amarillo en el Administrador de dispositivos; compruebe la propiedad StatusCode para obtener información más detallada sobre el tipo de error que se produjo.
- Falta indica que se esperaba que el dispositivo se enumerase en el equipo host, pero por alguna razón no lo hizo. La propiedad StatusCode contendrá el valor 24 para indicar esta situación errónea.
- DeviceHandleInUse indica que otro proceso se está comunicando actualmente con el dispositivo, lo que prohíbe este proveedor de instancias de Instrumental de administración de Windows (WMI) de sus solicitudes de comunicación. Pruebe a ejecutar el comando WMI de nuevo.
- Deshabilitado indica que la directiva actual del Modo de administración empresarial de Surface (SEMM) no se ha permitido y, por tanto, impide que la máquina host acceda al componente del dispositivo y lo use. Vea el campo de propiedad PolicyState para obtener más información.
- NotSupportedByWmi indica que el dock conectado no es compatible actualmente con este proveedor WMI. Este estado aparece para Surface Dock 1, que actualmente no es compatible con este proveedor de instancias WMI.
StatusCode uint32 Código de error del Administrador de dispositivos obtenido de la clase WMI de CIM_LogicalDevice (dentro de cimwin32.mof) La siguiente propiedad proporciona el código de error del Administrador de dispositivos para el componente de acoplamiento especificado. Un valor de cero (0) indica que el componente de acoplamiento funciona correctamente; un valor mayor que cero (0) indica un problema o un posible error con el componente de acoplamiento. Dado que el componente de acoplamiento puede enumerarse con varias interfaces de dispositivo, es posible que haya otros códigos de error de Device Manager. Este campo de propiedad solo muestra un solo código de error, incluso si hay varios disponibles. El Administrador de dispositivos etiqueta el dispositivo con un signo de exclamación amarillo solo cuando se han producido determinados códigos de error.
VendorId Cadena Cadena hexadecimal que puede oscilar entre "0x0000" y "0xFFFF" En la propiedad siguiente se anota el identificador de proveedor (VID) específico del componente del dispositivo.
Versión Cadena Cadena de versión, que tiene el formato siguiente: "x.y.z", donde x, y y z son valores numéricos. La siguiente propiedad especifica la versión actual del firmware, que se está ejecutando actualmente en el componente de dispositivo.

Obtén más información