about_WS-Management_Cmdlets

Artigo
11/06/2024

DESCRIÇÃO BREVE

Fornece uma visão geral dos Serviços Web para Gerenciamento (WS-Management) como plano de fundo para usar os cmdlets WS-Management no Windows PowerShell.

DESCRIÇÃO LONGA

Este tópico fornece uma visão geral dos Serviços Web para Gerenciamento (WS-Management) como plano de fundo para usar os cmdlets WS-Management no Windows PowerShell. Este tópico também fornece links para mais informações sobre o WS-Management. A implementação do WS-Management da Microsoft também é conhecida como Windows Remote Management (WinRM).

Sobre o WS-Management

O Gerenciamento Remoto do Windows é a implementação da Microsoft do protocolo WS-Management, um protocolo padrão baseado em SOAP e compatível com firewall que permite que hardware e sistemas operacionais de diferentes fornecedores interoperem. A especificação do protocolo WS-Management fornece uma maneira comum para os sistemas acessarem e trocarem informações de gerenciamento em uma infraestrutura de tecnologia da informação (TI). O WS-Management e a IPMI (Intelligent Platform Management Interface), juntamente com o Coletor de Eventos, são componentes dos recursos de Gerenciamento de Hardware do Windows.

O protocolo WS-Management baseia-se nas seguintes especificações padrão de serviço da Web: HTTPS, SOAP sobre HTTP (perfil WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration e WS-Eventing.

WS-Management e WMI

O WS-Management pode ser usado para recuperar dados expostos pela WMI (Instrumentação de Gerenciamento do Windows). Você pode obter dados WMI com scripts ou aplicativos que usam a API de Script WS-Management ou por meio da ferramenta de linha de comando WinRM. O WS-Management dá suporte à maioria das classes e operações WMI familiares, incluindo objetos inseridos. O WS-Management pode aproveitar o WMI para coletar dados sobre recursos ou gerenciar recursos em computadores baseados em Windows. Isso significa que você pode obter dados sobre objetos como discos, adaptadores de rede, serviços ou processos em sua empresa por meio do conjunto existente de classes WMI. Você também pode acessar os dados de hardware disponíveis no provedor WMI IPMI padrão.

WS-Management Provedor do Windows PowerShell (WSMan)

O provedor WSMan fornece uma exibição hierárquica das definições de configuração do WS-Management disponíveis. O provedor permite que você explore e defina as várias opções de configuração do WS-Management.

Configuração do WS-Management

Se o WS-Management não estiver instalado e configurado, a comunicação remota do Windows PowerShell não estará disponível, os cmdlets do WS-Management não serão executados, os scripts do WS-Management não serão executados e o provedor do WSMan não poderá executar operações de dados. A ferramenta de linha de comandos do WS-Management, o WinRM e o encaminhamento de eventos também dependem da configuração do WS-Management.

WS-Management Cmdlets

A funcionalidade WS-Management é implementada no Windows PowerShell por meio de um módulo que contém um conjunto de cmdlets e o provedor WSMan. Você pode usar esses cmdlets para concluir as tarefas de ponta a ponta necessárias para gerenciar as configurações do WS-Management em computadores locais e remotos.

Os cmdlets WS-Management a seguir estão disponíveis.

Cmdlets de conexão

Connect-WSMan: conecta o computador local ao serviço WS-Management (WinRM) em um computador remoto.
Disconnect-WSMan: desconecta o computador local do serviço WS-Management (WinRM) em um computador remoto.

Cmdlets de dados de gerenciamento

Get-WSManInstance: exibe informações de gerenciamento para uma instância de recurso especificada por um URI de recurso.
Invoke-WSManAction: Invoca uma ação no objeto de destino que é especificado pelo URI do recurso e pelos seletores.
New-WSManInstance: Cria uma nova instância de recurso de gerenciamento.
Remove-WSManInstance: exclui uma instância de recurso de gerenciamento.
Set-WSManInstance: modifica as informações de gerenciamento relacionadas a um recurso.

Cmdlets de instalação e configuração

Set-WSManQuickConfig: configura o computador local para gerenciamento remoto. Você pode usar o cmdlet Set-WSManQuickConfig para configurar o WS-Management para permitir conexões remotas com o serviço WS-Management (WinRM). O cmdlet Set-WSManQuickConfig executa as seguintes operações:
- Ele determina se o serviço WS-Management (WinRM) está em execução. Se o serviço WinRM não estiver em execução, o cmdlet Set-WSManQuickConfig iniciará o serviço.
- Ele define o tipo de inicialização do serviço WS-Management (WinRM) como automático.
- Ele cria um ouvinte que aceita solicitações de qualquer endereço IP. O protocolo de transporte padrão é HTTP.
- Ele habilita uma exceção de firewall para o tráfego do WS-Management.
Observação: Para executar esse cmdlet no Windows Vista, Windows Server 2008 e versões posteriores do Windows, você deve iniciar o Windows PowerShell com a opção "Executar como administrador".
Test-WSMan: Verifica se o WS-Management está instalado e configurado. O cmdlet Test-WSMan testa se o serviço WS-Management (WinRM) está em execução e configurado em um computador local ou remoto.
Disable-WSManCredSSP: desabilita a autenticação CredSSP em um computador cliente.
Enable-WSManCredSSP: habilita a autenticação CredSSP em um computador cliente.
Get-WSManCredSSP: obtém a configuração relacionada ao CredSSP para um computador cliente.