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-WSManEste 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 defaultEsse 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 defaultEsse 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
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).
