Test-WSMan
Testa se o serviço WinRM está em execução em um computador local ou remoto.
Sintaxe
Default (Padrão)
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
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 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, redireciona requisições por meio deste endpoint 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 delegue 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 Authentication, a solicitação Test-WSMan 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).
Propriedades do parâmetro
| Tipo: | AuthenticationMechanism |
| Valor padrão: | None |
| Valores aceitos: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | autenticação, am |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 do certificado, use o comando Get-Item ou Get-ChildItem na unidade Cert: do Windows PowerShell.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cn |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cred, c |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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á.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir objetos para esse cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma 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).
