Test-WSMan
Testa se o serviço WinRM está em execução em um computador local ou remoto.
Syntax
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
Este 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.
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
Este comando testa para ver 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 em que o nome de usuário e senha são enviados em texto não criptografado para o servidor ou proxy.Default
- Utilizar 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 a negociação para determinar se o protocolo Kerberos ou NTLM é usado.CredSSP
- Use a autenticação CredSSP (Credential Security Support Provider), que permite ao usuário delegar 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 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).
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Os certificados são utilizados na autenticação baseada em certificado do cliente. 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 de certificado, use o comando Get-Item ou Get-ChildItem
na unidade Windows PowerShell Cert:.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | cn |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 User01, Domain01\User01 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.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 o transporte, o valor do parâmetro ComputerName deve corresponder ao CN (nome comum) do certificado do servidor.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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á.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Não é possível 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).
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de