O Test-WsMan é um cmdlet do PowerShell utilizado para verificar se um computador remoto está configurado para responder a solicitações de gerenciamento baseadas no protocolo WS-Management. Este protocolo é usado para gerenciar sistemas operacionais e dispositivos de forma remota, e é parte integrante do Windows Remote Management (WinRM). Este artigo irá guiá-lo através do uso do Test-WsMan no ambiente Windows, incluindo exemplos práticos.

O que é o Test-WsMan?

O Test-WsMan é um cmdlet que permite verificar se um serviço WS-Management está disponível em um computador remoto. Ele é particularmente útil para diagnosticar problemas de conectividade ou configuração com o WinRM. O cmdlet envia uma solicitação ao serviço WS-Management no computador remoto e retorna informações sobre a versão do protocolo, se a solicitação for bem-sucedida.

Pré-requisitos

Antes de usar o Test-WsMan, certifique-se de que o WinRM está habilitado no computador remoto. Você pode habilitar o WinRM executando o seguinte comando no PowerShell com privilégios de administrador:

Enable-PSRemoting -Force

Exemplos Práticos

Exemplo 1: Testando a conectividade WS-Management em um computador local

Para testar se o WS-Management está configurado corretamente no seu computador local, execute o seguinte comando no PowerShell:

Test-WsMan -ComputerName localhost

Se o serviço estiver funcionando corretamente, você verá uma saída com informações sobre a versão do protocolo WS-Management.

Exemplo 2: Testando a conectividade WS-Management em um computador remoto

Para verificar a conectividade com um computador remoto, substitua "RemoteComputerName" pelo nome ou endereço IP do computador que você deseja testar:

Test-WsMan -ComputerName RemoteComputerName

Se o computador remoto estiver configurado corretamente para responder a solicitações WS-Management, você verá uma saída semelhante à do exemplo local.

Exemplo 3: Especificando credenciais para autenticação

Caso o computador remoto exija autenticação, você pode especificar credenciais usando o parâmetro -Credential:

$credential = Get-Credential
Test-WsMan -ComputerName RemoteComputerName -Credential $credential

Este comando irá solicitar que você insira um nome de usuário e senha para autenticação.

Resolução de Problemas

Se o Test-WsMan falhar, verifique as seguintes configurações:

1. Firewall: Certifique-se de que o firewall está configurado para permitir conexões WS-Management.
2. Serviço WinRM: Verifique se o serviço WinRM está em execução no computador remoto.
3. Configuração de Rede: Certifique-se de que o nome do computador ou endereço IP está correto e acessível.