Gerenciar o Surface Docks com WMI
O suporte do Windows Management Instrumentation (WMI) fornece um conjunto avançado de informações de diagnóstico que permitem aos administradores de TI monitorizarem e gerirem remotamente o firmware, o estado da política e os dados relacionados mais recentes para dispositivos Surface Dock 2 e Surface Thunderbolt 4 Dock. Pode utilizar o WMI com o Windows PowerShell, o System Center Operations Manager e outras ferramentas. Para obter mais informações sobre a WMI, consulte Trabalhar com a WMI.
Ativar o suporte da WMI
Estação de Ancoragem para Surface Thunderbolt 4
Aceda a Firmware e Controladores da Estação de Ancoragem Thunderbolt 4 do Surface e transfira o pacote adequado:
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi
- Surface Pro (quinta geração e posterior)
- Surface Book (segunda geração e posterior)
- Surface Go (todas as gerações)
- Surface Laptop (todas as gerações)
- Surface Laptop Go (todas as gerações)
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi
- Surface Pro 9 com 5G
- Surface Pro X
Surface Dock 2
Aceda a Firmware e Controladores da Estação de Ancoragem para Surface 2 e transfira o pacote adequado:
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi
- Surface Pro (quinta geração e posterior)
- Surface Book (segunda geração e posterior)
- Surface Go (todas as gerações)
- Surface Laptop (todas as gerações)
- Surface Laptop Go (todas as gerações)
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi
- Surface Pro 9 com 5G
- Surface Pro X
Utilizar o WMI com a Estação de Ancoragem para Surface
As seguintes instruções aplicam-se à Estação de Ancoragem para Surface 2 e Surface Thunderbolt 4 Dock.
Para enumerar todas as instâncias de componentes da estação de ancoragem:
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"Para aceder às descrições da Propriedade da Classe WMI, abra uma linha de comandos e introduza comandos WMI em que Propriedade é uma das propriedades listadas na Tabela 1.
Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
Exemplo: Para aceder à descrição da propriedade Modelo de Informações Comuns da Versão (CIM), introduza o seguinte:
(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value
Tabela 1. Referência WMI da Estação de Ancoragem para Surface
| Propriedade | Tipo | Valores Esperados | Descrição |
|---|---|---|---|
| ComponentName | String |
Estação de Ancoragem para Surface Thunderbolt 4 "Microcontrolador" "Controlador Thunderbolt 4" "Concentrador USB" "Controlador de Entrega de Energia 1" "Controlador de Entrega de Energia 2" "Codec de Áudio" "Controlador Ethernet" "DockSerialNumber" (comprimento: 14 - Por exemplo, 0V3379X22463GH) Surface Dock 2 "Microcontrolador" "Concentrador USB 1" "CONCENTRADOR USB 2" "Apresentar Hub de Portas" "Controlador de Entrega de Energia" "Codec de Áudio" "Controlador Ethernet" |
A propriedade seguinte lista o nome específico do componente do dispositivo ao qual correspondem os dados da classe CIM (Common Information Model). |
| DeviceName | String | "Surface Dock 1" "Surface Dock 2" "Microsoft Surface Thunderbolt 4 Dock" |
A seguinte propriedade contém o nome do dispositivo de ancoragem ao qual pertence o componente de dispositivo específico. |
| DockSerialNumber | String | Um número de série de doze (12) dígitos que contém apenas valores numéricos | A seguinte propriedade regista o número de série do dispositivo de ancoragem anexado. Este número de série é exatamente o mesmo para cada componente que pertencem ao mesmo dispositivo de estação de ancoragem. Para referência, este número de série pode ser encontrado fisicamente na parte inferior da própria Estação de Ancoragem para Surface. |
| Id | int16 | 0, 1, 2, ..., 65535 | A propriedade seguinte é um ID exclusivo que começa a partir de zero (0) e conta para cima. Esta variável é utilizada para numerar as instâncias WMI enumeradas. |
| LastUpdateStatus | String | "Êxito" "PendingDockReattach" "Falhou" |
A propriedade seguinte detalha o estado da última tentativa de Atualização de Firmware do Componente (CFU) para o componente do dispositivo em questão. Os valores possíveis são: Success,PendingDock Reattach e Failed. - Success indica que o firmware novo aplicado anteriormente foi aplicado com êxito - A Atualização da Estação de Ancoragem Pendente indica que existe uma nova atualização pendente para o componente do dispositivo e o utilizador tem de desanexar e voltar a encaixar o conector surface da Dock para aplicar a nova atualização. - Falha indica que ocorreu um possível erro legítimo durante o processo da CFU ou o periférico não arrancou na versão esperada. No caso Com falhas , isto não é uma indicação de que o dispositivo não está a funcionar, mas ocorreu um erro ao tentar atualizar o dispositivo. Nesse caso, o firmware anterior continua a ser executado. |
| PolicyState | String | "Ativado" "Desativado" |
A seguinte propriedade indica a política atual do Modo de Gestão Empresarial (SEMM) do Surface para o componente do dispositivo. Os valores possíveis são: Ativado e Desativado. - Ativado indica que o sistema SEMM permitiu que o dispositivo anfitrião acedesse e utilizasse o componente do dispositivo - Desativado indica que o sistema SEMM não foi permitido e, assim, impediu o computador anfitrião de aceder e utilizar o componente do dispositivo. |
| ProductId | Cadeia[] | Uma lista de cadeias hexadecimais, que podem variar entre "0x0000" e "0xFFFF" | A seguinte propriedade classifica o ID do Produto (PID) do componente do dispositivo. É possível que exista mais do que um PID listado. No caso de um Concentrador USB, por exemplo, os dispositivos de Super Velocidade (SS) e de Alta Velocidade (HS) são agrupados num "Hub" singular. Por conseguinte, dois (2) PIDs seriam listados nesta matriz. |
| ProvisionedState | boolean | Verdadeiro ou Falso | A seguinte propriedade descreve o estado aprovisionado do Modo de Gestão Empresarial do Surface (SEMM) do dispositivo Surface Dock. O estado aprovisionado é exatamente o mesmo para cada componente que pertencem ao mesmo dispositivo de estação de ancoragem. Os valores possíveis são: Verdadeiro ou Falso. Um valor verdadeiro indica que o dispositivo da Estação de Ancoragem para Surface é atualmente gerido e, assim, a funcionalidade de porta pode ser restrita. Veja o campo de propriedade "PolicyState" para obter mais informações. Um valor falso indica que o dispositivo da Estação de Ancoragem para Surface não é atualmente gerido e não tem restrições de funcionalidade impostas. |
| Status | String | "OK" "Desligado" "Erro" "Em Falta" "DeviceHandleInUse" "Desativado" "NotSupportedByWmi" |
A seguinte propriedade descreve o estado da ligação da Dock ao computador anfitrião. Os valores possíveis são: OK,Desligado,Erro,EmFalta,DeviceHandleInUse,Desativado e NotSupportedByWmi. - OK indica que o dispositivo está ligado com êxito ao computador anfitrião e não existem problemas, o que inibe a funcionalidade - Desligado indica que o conector do Surface, que fornece a ligação para todos os componentes do dispositivo, não está atualmente ligado ao computador anfitrião. - O erro indica um potencial problema com a instância do dispositivo e a interface do dispositivo foi etiquetada com um ponto de exclamação amarelo no Gestor de Dispositivos – verifique a propriedade StatusCode para obter informações mais detalhadas sobre o tipo de erro ocorrido. - Em falta indica que era esperado que o dispositivo tivesse enumerado no computador anfitrião, mas por algum motivo não o fez. A propriedade StatusCode irá conter o valor de 24 para indicar esta situação errónea. - DeviceHandleInUse indica que outro processo está atualmente a comunicar com o dispositivo, o que proíbe este Fornecedor de Instâncias do Windows Management Instrumentation (WMI) dos respetivos pedidos de comunicação. Tente executar novamente o comando WMI! - Desativado indica que a política atual do Modo de Gestão Empresarial (SEMM) do Surface não foi permitida e, assim, impediu que o computador anfitrião acedesse e utilizasse o componente do dispositivo. Veja o campo de propriedade PolicyState para obter mais informações. - NotSupportedByWmi indica que a estação de ancoragem ligada não é atualmente suportada por este Fornecedor WMI. Este estado é apresentado para o Surface Dock 1, que atualmente não é suportado por este Fornecedor de Instâncias WMI. |
| StatusCode | int32 | Código de Erro do Gestor de Dispositivos obtido a partir da Classe WMI de CIM_LogicalDevice (em cimwin32.mof) | A seguinte propriedade fornece o código de erro do Gestor de Dispositivos para o componente de estação de ancoragem especificado. Um valor de zero (0) indica que o componente de ancoragem está a funcionar corretamente; um valor superior a zero (0) indica um problema ou um possível erro com o componente da estação de ancoragem. Uma vez que o componente de ancoragem pode enumerar com várias interfaces de dispositivo, é possível que existam outros códigos de erro do Gestor de Dispositivos. Este campo de propriedade lista apenas um único código de erro, mesmo que estejam disponíveis múltiplos. O Gestor de Dispositivos etiqueta o dispositivo com um ponto de exclamação amarelo apenas quando determinados códigos de erro ocorrerem. |
| VendorId | String | Uma cadeia hexadecim que pode variar entre "0x0000" e "0xFFFF" | A propriedade seguinte anota o ID de Fornecedor (VID) específico do componente do dispositivo. |
| Versão | String | Uma cadeia de versão, que tem o formulário da seguinte forma: "x.y.z", em que x, y e z são valores numéricos. | A seguinte propriedade especifica a versão atual do firmware, que está atualmente em execução no componente do dispositivo. |