Testa se o serviço WinRM está em execução em um computador local ou remoto.
Sintaxe
Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]
Descrição
O cmdlet Test-WSMan envia uma solicitação de identificação que determina se o serviço WinRM está em execução em um computador local ou remoto. Se o computador testado está executando o serviço, o cmdlet exibe o esquema de identidade do WS-Management, a versão do protocolo, o fornecedor do produto e a versão de produto do serviço testado.
Parâmetros
-Authentication <Authentication>
Especifica o mecanismo de autenticação a ser usado no servidor. Os valores possíveis são:
- Basic: é um esquema em que o nome de usuário e a senha são enviados como texto não criptografado para o servidor ou o proxy.
- Default: usa o método de autenticação implementado pelo protocolo WS-Management.
- Digest: é um esquema de desafio-resposta que usa uma cadeia de caracteres de dados especificada pelo servidor para o desafio.
- Kerberos: o computador cliente e o servidor se autenticam mutuamente usando certificados Kerberos.
- Negotiate: é um esquema desafio-resposta que negocia com o servidor ou o proxy para determinar o esquema a ser usado para autenticação. Por exemplo, o valor desse parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é usado.
- CredSSP: use a autenticação CredSSP (Credential Security Service Provider), que permite ao usuário delegar credenciais. Esta opção é projetada para comandos executados em um computador remoto, mas que coletam dados ou executam comandos adicionais em outros computadores remotos.
Cuidado: o CredSSP delega as credenciais do usuário do computador local para um computador remoto. Essa prática aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, quando as credenciais forem passadas para ele, elas poderão ser usadas para controlar a sessão de rede.
Importante: se o parâmetro de autenticação não for especificado, a solicitação de Test-WSMan será enviada à máquina remota anonimamente (sem usar autenticação). Se a solicitação de Test-WSMan for feita anonimamente, ela não retornará informações específicas à versão do sistema operacional. Em vez disso, Test-WSMan exibirá valores nulos para a versão de sistema operacional e o nível do pacote de serviço (OS: 0.0.0 SP: 0.0).
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-ComputerName <string>
Especifica o computador em relação ao qual você deseja executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, o host local ou um ponto (.) para especificar o computador local. O padrão é o computador local. Quando o computador remoto está em um domínio diferente do usuário, um nome de domínio totalmente qualificado deve ser usado.
Necessário? |
false |
Posição? |
1 |
Valor padrão |
localhost |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual. Digite um nome de usuário, como “User01”, “Domain01\User01” ou User@Domain.com. Ou insira um objeto PSCredential, como aquele retornado pelo cmdlet Get-Credential. Quando você digitar um nome de usuário, uma senha será solicitada.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
None Este cmdlet não aceita entrada. |
Saídas |
None Este cmdlet não gera objeto de saída. |
Observações
Por padrão, o cmdlet Test-WSMan consulta o serviço WinRM sem usar autenticação e não devolve qualquer informação específica à versão do sistema operacional. Em vez disso, ele exibe valores nulos para a versão de sistema operacional e o nível do pacote de serviço (OS: 0.0.0 SP: 0.0).
Exemplo 1
C:\PS>test-wsman wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Descrição ----------- Este comando determina se o serviço WinRM está em execução no computador local ou em um computador remoto.
Exemplo 2
C:\PS>test-wsman -computername server01 wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Descrição ----------- Este comando determina se o serviço WinRM está em execução no computador denominado server01.
Exemplo 3
C:\PS>test-wsman -authentication default wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.0.6001 SP: 1.0 Stack: 2.0 Descrição ----------- Este comando testa para verificar se o serviço WS-Management (WinRM) está em execução no computador local com o uso do parâmetro de autenticação. O uso do parâmetro de autenticação permite que o cmdlet Test-WSMan retorne a versão do sistema operacional.
Exemplo 4
C:\PS>test-wsman -computername server01 -authentication default wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.1.7021 SP: 0.0 Stack: 2.0 Descrição ----------- Este comando testa se o serviço WS-Management (WinRM) está em execução no computador denominado server01 com o uso do parâmetro de autenticação. O uso do parâmetro de autenticação permite que o cmdlet Test-WSMan retorne a versão do sistema operacional.
See Also