Compartilhar via

Test-WSMan

  • Referência
Módulo:
Microsoft.WSMan.Management

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

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

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 estiver executando o serviço, o cmdlet exibirá o esquema de identidade 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"

Este 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 para ver se o serviço WS-Management (WinRM) está em execução no computador local usando o parâmetro de autenticação.

Usar o parâmetro de autenticação permite que Test-WSMan retornem 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.

Usar o parâmetro de autenticação permite que Test-WSMan retornem 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 do ponto de extremidade remoto está no seguinte formato:

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

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

O IIS (Serviços de Informações da Internet), que hospeda a sessão, encaminha 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 será 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 os Serviços Web para Gerenciamento (WS-Management) para obter 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 este parâmetro são:

  • Basic - Básico é um esquema no qual o nome de usuário e a senha são enviados em texto claro 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 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 que a negociação determine se o protocolo Kerberos ou NTLM é usado.
  • CredSSP - Use a autenticação credSSP (Provedor de Suporte à Segurança de Credencial), que permite que o usuário delegar credenciais. Essa opção foi projetada para 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, quando as credenciais forem passadas para ele, as credenciais poderão ser usadas para controlar a sessão de rede.

Importante

Se você não especificar o parâmetro de Autenticação , a 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 para a 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 que tem permissão para executar essa ação. Insira a impressão digital do certificado.

Os certificados são usados na autenticação baseada em certificado do cliente. Eles podem ser mapeados apenas para contas de usuário local; eles não funcionam com contas de domínio.

Para obter uma impressão digital de certificado, use o comando Get-Item ou Get-ChildItem no Certificado do Windows PowerShell: unidade.

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 estiver em um domínio diferente do usuário, você deverá usar um nome de domínio totalmente qualificado. Você pode redirecionar um valor para esse 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 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 um retornado pelo cmdlet Get-Credential. 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, o SSL não é usado.

WS-Management criptografa todo o conteúdo do Windows PowerShell 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

Esse cmdlet não aceita nenhuma entrada.

Saídas

None

Esse cmdlet não gera nenhum objeto de saída.

Observações

Por padrão, o cmdlet Test-WSMan consulta o serviço WinRM sem usar a autenticação e não retorna informações específicas 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).