about_WS-Management_Cmdlets

Artigo
10/04/2023

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 obter mais informações sobre o WS-Management. A implementação Microsoft do WS-Management 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, amigável ao 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). WS-Management e Intelligent Platform Management Interface (IPMI), juntamente com o coletor de eventos, são componentes dos recursos de gerenciamento de hardware do Windows.

O protocolo WS-Management é baseado nas seguintes especificações de serviço Web padrão: 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 pelo WMI (Instrumentação de Gerenciamento do Windows). Você pode obter dados WMI com scripts ou aplicativos que usam a API WS-Management Scripting ou por meio da ferramenta de linha de comando WinRM. O WS-Management oferece suporte à maioria das classes e operações WMI familiares, incluindo objetos incorporados. O WS-Management pode aproveitar o WMI para coletar dados sobre recursos ou gerenciar recursos em computadores baseados no 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 WS-Management não serão executados, os scripts WS-Management não serão executados e o provedor WSMan não poderá executar operações de dados. A ferramenta de linha de comando 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 seguintes cmdlets WS-Management 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 especificada 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 WS-Management.
Nota: 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.