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




Sumário