Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O suporte à Instrumentação de Gerenciamento do Windows (WMI) fornece um conjunto avançado de informações de diagnóstico, permitindo que os administradores de TI monitorem e gerenciem remotamente o firmware mais recente, o estado da política e os dados relacionados para dispositivos Surface Dock 2 e Surface Thunderbolt 4 Dock. Você pode usar o WMI com o Windows PowerShell, o System Center Operations Manager e outras ferramentas. Para obter mais informações sobre o WMI, consulte Trabalhando com o WMI.
Habilitar suporte a WMI
Encaixe Thunderbolt 4 para Surface
Acesse Firmware e drivers do Surface Thunderbolt 4 Dock e baixe o pacote apropriado:
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
Vá para Firmware e Drivers do Surface Dock 2 e baixe o pacote apropriado:
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
Usando o WMI com o Surface Dock
As instruções a seguir se aplicam ao Surface Dock 2 e ao Surface Thunderbolt 4 Dock.
Para enumerar todas as instâncias do componente dock:
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"Para acessar as descrições de Propriedade de Classe WMI, abra um prompt de comando e insira comandos WMI em que Propriedade é uma das propriedades listadas na Tabela 1.
Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
Exemplo: Para acessar a descrição da propriedade do Modelo de Informação Comum (CIM), insira o seguinte:
(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value
Tabela 1. Referência de WMI do Surface Dock
| Propriedade | Tipo | Valor esperado | Descrição |
|---|---|---|---|
| ComponentName | String |
Encaixe Thunderbolt 4 para Surface "Microcontrolador" "Controle Thunderbolt 4" "Hub USB" "Power Delivery Controller 1" "Power Delivery Controller 2" "Codec de áudio" "Controlador Ethernet" "DockSerialNumber" (comprimento: 14 – por exemplo, 0V3379X22463GH) Surface Dock 2 "Microcontrolador" "Hub USB 1" "Hub USB 2" "Display Port Hub" "Power Delivery Controller" "Codec de áudio" "Controlador Ethernet" |
A propriedade a seguir lista o nome específico do componente do dispositivo ao qual os dados da classe CIM (Modelo de Informação Comum) correspondem. |
| DeviceName | String | "Surface Dock 1" "Surface Dock 2" "Microsoft Surface Thunderbolt 4 Dock" |
A propriedade a seguir contém o nome do dispositivo de encaixe ao qual o componente de dispositivo específico pertence. |
| DockSerialNumber | String | Um número de série de doze (12) dígitos contendo apenas valores numéricos | A propriedade a seguir registra o número de série do dispositivo de encaixe conectado. Esse número de série é exatamente o mesmo para todos os componentes, pois eles pertencem ao mesmo dispositivo de encaixe. Para referência, esse número de série pode ser encontrado fisicamente na parte inferior do próprio Surface Dock. |
| Id | uint16 | 0, 1, 2, ..., 65535 | A propriedade a seguir é uma ID exclusiva que começa em zero (0) e conta acima. Essa variável é usada para numerar as instâncias WMI enumeradas. |
| LastUpdateStatus | String | "Sucesso" "PendingDockReattach" "Falhou" |
A propriedade a seguir detalha o último status de tentativa de atualização de firmware de componente (CFU) para o componente do dispositivo em questão. Os valores possíveis são: Êxito,Dock Pendente, Reanexação eFalha. - Êxito indica que o novo firmware aplicado anteriormente foi aplicado com êxito - A Reanexação Pendente do Encaixe indica que há uma nova atualização pendente para o componente do dispositivo e o usuário deve desanexar e reconectar o conector Surface do Encaixe para aplicar a nova atualização. - Falha indica que um possível erro legítimo ocorreu durante o processo CFU ou o periférico não inicializou na versão esperada. No caso de Falha , isso não é uma indicação de que o dispositivo não está funcionando, mas algo errado ocorreu ao tentar atualizar o dispositivo. Nesse caso, o firmware anterior continua a ser executado. |
| PolicyState | String | "Habilitado" "Desabilitado" |
A propriedade a seguir indica a política atual do SEMM (Modo de Gerenciamento Empresarial) do Surface para o componente de dispositivo. Os valores possíveis são: Habilitado e Desabilitado. - Habilitado indica que o sistema SEMM permitiu que o dispositivo host acessasse e usasse o componente do dispositivo - Desabilitado indica que o sistema SEMM não permitiu e, portanto, impediu que o computador host acessasse e usasse o componente do dispositivo. |
| ProductId | Cadeia de caracteres[] | Uma lista de strings hexadecimais, que podem variar de "0x0000" a "0xFFFF" | A propriedade a seguir classifica a PID (ID do produto) do componente do dispositivo. É possível que haja mais de um PID listado. No caso de um hub USB, por exemplo, os dispositivos de super velocidade (SS) e alta velocidade (HS) são agrupados em um único "hub". Portanto, dois (2) PIDs seriam listados nessa matriz. |
| ProvisionedState | boolean | Verdadeira ou Falsa | A propriedade a seguir descreve o estado provisionado do SEMM (Modo de Gerenciamento Empresarial do Surface) do dispositivo do Surface Dock. O estado provisionado é exatamente o mesmo para todos os componentes, pois eles pertencem ao mesmo dispositivo de encaixe. Os valores possíveis são: True ou False. Um valor true indica que o dispositivo do Surface Dock está atualmente gerenciado e, portanto, a funcionalidade da porta pode ser restrita. Consulte o campo de propriedade "PolicyState" para obter mais informações. Um valor falso indica que o dispositivo do Surface Dock não é gerenciado no momento e não tem restrições de recursos impostas. |
| Status | String | "ESTÁ BEM" "Desconectado" "Erro" "Desaparecido" "DeviceHandleInUse" "Desabilitado" "NotSupportedByWmi" |
A propriedade a seguir descreve o estado da conexão do Dock com a máquina host. Os valores possíveis são: OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled e NotSupportedByWmi. - OK indica que o dispositivo foi conectado com êxito ao computador host e não há problemas, o que inibiria sua funcionalidade - Desconectado indica que o conector do Surface, que fornece a conexão para todos os componentes do dispositivo, não está conectado ao computador host no momento. - indica um possível problema com a instância do dispositivo e a interface do dispositivo provavelmente foi rotulada com um ponto de exclamação amarelo no Gerenciador de Dispositivos – marque a propriedade StatusCode para obter informações mais detalhadas sobre o tipo de erro que ocorreu. - Ausente indica que se esperava que o dispositivo tivesse enumerado no computador host, mas por algum motivo isso não aconteceu. A propriedade StatusCode conterá o valor de 24 para indicar essa situação errônea. - DeviceHandleInUse indica que outro processo está se comunicando com o dispositivo no momento, o que proíbe esse provedor de instância WMI (Instrumentação de Gerenciamento do Windows) de suas solicitações de comunicação. Tente executar o comando WMI novamente! - Desabilitado indica que a política atual do Surface Enterprise Management Mode (SEMM) não permitiu e, portanto, impediu o computador host de acessar e usar o componente do dispositivo. Consulte o campo de propriedade PolicyState para obter mais informações. - NotSupportedByWmi indica que o encaixe conectado não tem suporte no momento por esse provedor WMI. Esse status é exibido para o Surface Dock 1, que atualmente não é compatível com este provedor de instância WMI. |
| StatusCode | uint32 | Gerenciador de Dispositivos Código de Erro obtido da classe WMI do CIM_LogicalDevice (dentro de cimwin32.mof) | A propriedade a seguir fornece o código de erro do Gerenciador de Dispositivos para o componente de encaixe fornecido. Um valor zero (0) indica que o componente dock está funcionando corretamente; Um valor maior que zero (0) indica um problema ou um possível erro com o componente Encaixe. Como o componente do encaixe pode ser enumerado com várias interfaces de dispositivo, é possível que haja outros códigos de erro do Gerenciador de Dispositivos. Esse campo de propriedade só lista um único código de erro, mesmo que haja vários disponíveis. O Gerenciador de Dispositivos rotula o dispositivo com um ponto de exclamação amarelo somente quando determinados códigos de erro ocorrem. |
| VendorId | String | Uma cadeia de caracteres hexadecimal que pode variar de "0x0000" a "0xFFFF" | A propriedade a seguir observa a ID do fornecedor (VID) específica do componente de dispositivo. |
| Versão | String | Uma cadeia de caracteres de versão, que tem o formato da seguinte maneira: "x.y.z", em que x, y e z são valores numéricos. | A propriedade a seguir especifica a versão atual do firmware, que está em execução no componente do dispositivo. |