Test-WSMan

Testa se o serviço WinRM está em execução em um computador local ou remoto.

Sintaxe

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O Test-WSMan cmdlet 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 estiver executando o serviço, o cmdlet exibirá o esquema de identidade do WS-Management, a versão do protocolo, o fornecedor do produto e a versão do produto do serviço testado.

Exemplos

Exemplo 1: Determinar o status do serviço WinRM

Test-WSMan

Este comando determina se o serviço WinRM está em execução no computador local ou em um computador remoto.

Exemplo 2: Determinar o status do serviço WinRM em um computador remoto

Test-WSMan -ComputerName "server01"

Esse comando determina se o serviço WinRM está em execução no computador server01.

Exemplo 3: Determinar o status do serviço WinRM e a versão do sistema operacional

Test-WSMan -Authentication default

Esse comando testa se o serviço WS-Management (WinRM) está em execução no computador local usando o parâmetro de autenticação.

O uso do parâmetro authentication permite Test-WSMan retornar a versão do sistema operacional.

Exemplo 4: Determinar o status do serviço WinRM e a versão do sistema operacional em um computador remoto

Test-WSMan -ComputerName "server01" -Authentication default

Esse comando testa se o serviço WS-Management (WinRM) está em execução no computador chamado server01 usando o parâmetro de autenticação.

O uso do parâmetro authentication permite Test-WSMan retornar a versão do sistema operacional.

Parâmetros

-ApplicationName

Especifica o nome do aplicativo na conexão. O valor padrão do parâmetro ApplicationName é WSMAN. O identificador completo para o ponto de extremidade remoto é no seguinte formato:

<Transport>://<Server>:<Port>/<ApplicationName>

Por exemplo: http://server01:8080/WSMAN

Os Serviços de Informações da Internet (IIS), que hospedam a sessão, encaminham solicitações com esse ponto de extremidade para o aplicativo especificado. Essa configuração padrão do WSMAN é apropriada para a maioria dos usos. Esse parâmetro foi projetado para ser usado se muitos computadores estabelecerem conexões remotas com um computador que esteja executando o Windows PowerShell. Nesse caso, o IIS hospeda o Web Services for Management (WS-Management) para maior eficiência.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Authentication

Especifica o mecanismo de autenticação a ser usado no servidor. Os valores aceitáveis para esse parâmetro são:

  • Basic - Básico é um esquema no qual o nome de usuário e a senha são enviados em texto não criptografado para o servidor ou proxy.
  • Default - Use o método de autenticação implementado pelo protocolo WS-Management. Esse é o padrão.
  • 1 - 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 - Negociar é um esquema de desafio-resposta que negocia com o servidor ou proxy para determinar o esquema a ser usado para autenticação. Por exemplo, esse valor de parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é usado.
  • CredSSP - Use a autenticação do Provedor de Suporte de Segurança de Credenciais (CredSSP), que permite que o usuário delegue credenciais. Esta opção foi criada para os comandos executados em um computador remoto, mas 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, no momento em que as credenciais forem passadas a ele essas credenciais poderão ser usadas para controlar a sessão de rede.

Importante

Se você não especificar o parâmetro Authentication , a Test-WSMan solicitação será enviada ao computador remoto anonimamente, sem usar a autenticação. Se a solicitação for feita anonimamente, ela não retornará nenhuma informação específica da versão do sistema operacional. Em vez disso, esse cmdlet exibe valores nulos para a versão do sistema operacional e o nível do service pack (SO: 0.0.0 SP: 0.0).

Tipo:AuthenticationMechanism
Aliases:auth, am
Valores aceitos:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificateThumbprint

Especifica o certificado de chave pública digital (X509) de uma conta de usuário com permissão para executar essa ação. Insira a impressão digital do certificado.

Certificados digitais são empregados na autenticação de clientes baseada em certificados. Eles podem ser mapeados somente para contas de usuário local; eles não funcionam com contas de domínio.

Para obter uma impressão digital do certificado, use o comando Get-Item or Get-ChildItem na unidade Cert: do Windows PowerShell.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputerName

Especifica o computador no qual 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, use localhost ou use um ponto (.) para especificar o computador local. O computador local é o padrão. Quando o computador remoto está em um domínio diferente do usuário, deve-se usar um nome de domínio totalmente qualificado. É possível redirecionar um valor desse parâmetro para o cmdlet.

Tipo:String
Aliases:cn
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Credential

Especifica uma conta de usuário que tem permissão para executar esta ação. O padrão é o usuário atual. Digite um nome de usuário, como Usuário01, Domínio01\Usuário01 ou User@Domain.com. Ou insira um objeto PSCredential , como um retornado pelo Get-Credential cmdlet. Quando você digita um nome de usuário, esse cmdlet solicita uma senha.

Tipo:PSCredential
Aliases:cred, c
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Port

Especifica a porta a ser usada quando o cliente se conecta ao serviço WinRM. Quando o transporte é HTTP, a porta padrão é 80. Quando o transporte é HTTPS, a porta padrão é 443.

Quando você usa HTTPS como transporte, o valor do parâmetro ComputerName deve corresponder ao CN (nome comum) do certificado do servidor.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é usado para estabelecer uma conexão com o computador remoto. Por padrão, SSL não é usado.

O WS-Management criptografa todo o conteúdo do Windows PowerShell que é transmitido pela rede. O parâmetro UseSSL permite especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta usada para a conexão e você especificar esse parâmetro, o comando falhará.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

XmlElement

Esse cmdlet retorna um objeto XmlElement que representa o resultado do teste.

Observações

Por padrão, o Test-WSMan cmdlet consulta o serviço WinRM sem usar autenticação e não retorna nenhuma informação específica para a versão do sistema operacional. Em vez disso, ele exibe valores nulos para a versão do sistema operacional e o nível do service pack (SO: 0.0.0 SP: 0.0).