about_WS-Management_Cmdlets

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

TÓPICO

about_WS-Management_Cmdlets

DESCRIÇÃO BREVE

Fornece uma visão geral do Web Services for Management (WS-Management) como tela de fundo para usar os cmdlets do WS-Management no Windows PowerShell®.

DESCRIÇÃO LONGA

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

SOBRE O WS-MANAGEMENT

O Gerenciamento Remoto do Windows é a implementação da Microsoft do protocolo WS-Management, um protocolo amigável para firewalls com base em SOAP padrão que permite que o hardware e os sistemas operacionais de fornecedores diferentes operem em conjunto. 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 TI (Tecnologia da Informação). O WS-Management e a IPMI (Interface de Gerenciamento de Plataforma Inteligente), juntamente com o Coletor de Eventos, são componentes dos recursos do Gerenciamento de Hardware do Windows.

O protocolo WS-Management se baseia 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 os dados expostos pela WMI (Instrumentação de Gerenciamento do Windows). Você pode obter dados da WMI com scripts ou aplicativos que usam a API de scripts do WS-Management ou por meio da ferramenta de linha de comando do WinRM. O WS-Management dá suporte para a maioria das classes e operações da WMI familiares, inclusive objetos inseridos. O WS-Management pode aproveitar a WMI para coletar dados sobre recursos ou para 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 de um conjunto existente de classes de WMI. Você também pode acessar os dados de hardware que estão disponíveis no provedor de WMI IPMI.

PROVEDOR DO WS-MANAGEMENT WINDOWS POWERSHELL (WSMan)

O provedor do WSMan fornece uma exibição hierárquica das definições de configuração do WS-Management disponíveis. O provedor permite explorar e definir 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 comando do WS-Management, o WinRM e o encaminhamento de eventos também dependem da configuração do WS-Management.

CMDLETS DO WS-MANAGEMENT

A funcionalidade do WS-Management é implementada no Windows PowerShell por meio de um módulo que contém um conjunto de cmdlets e do 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 do 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 do recurso especificada por um URI de recurso.

Invoke-WSManAction:

Invoca uma ação no objeto de destino especificado pelo URI de recurso e pelos seletores.

New-WSManInstance:

Cria uma nova instância de recursos de gerenciamento.

Remove-WSManInstance:

Exclui uma instância do recurso de gerenciamento.

Set-WSManInstance:

Modifica as informações de gerenciamento que estão relacionadas a um recurso.

CMDLETS DE 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 para o serviço WS-Management (WinRM). O cmdlet Set-WSManQuickConfig executa as seguintes operações:

- 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 inicia 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 permite 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 à CredSSP para um computador cliente.

CMDLETS ESPECÍFICOS DO WS-MANAGEMENT

-- New-WSManSessionOption: Cria um objeto WSManSessionOption para usar como entrada para um ou mais parâmetros de um cmdlet do WS-Management.

Informações adicionais sobre o WS-Management

Para obter mais informações sobre o WS-Management, consulte os seguintes tópicos na biblioteca MSDN (Microsoft Developer Network).

"Windows Remote Management" (Gerenciamento Remoto do Windows)

https://go.microsoft.com/fwlink/?LinkId=142321

"About Windows Remote Management" (Sobre o Gerenciamento Remoto do Windows)

https://go.microsoft.com/fwlink/?LinkId=142322

"Installation and Configuration for Windows Remote Management" (Instalação e configuração do Gerenciamento Remoto do Windows)

https://go.microsoft.com/fwlink/?LinkId=142323

"Windows Remote Management Architecture" (Arquitetura do Gerenciamento Remoto do Windows)

https://go.microsoft.com/fwlink/?LinkId=142324

"WS-Management Protocol" (Protocolo do WS-Management)

https://go.microsoft.com/fwlink/?LinkId=142325

"Windows Remote Management and WMI" (Gerenciamento Remoto do Windows e WMI)

https://go.microsoft.com/fwlink/?LinkId=142326

"Resource URIs" (URIs de recurso)

https://go.microsoft.com/fwlink/?LinkId=142327

"Remote Hardware Management" (Gerenciamento de hardware remoto)

https://go.microsoft.com/fwlink/?LinkId=142328

"Events" (Eventos)

https://go.microsoft.com/fwlink/?LinkId=142329

CONSULTE TAMBÉM

Versão online: https://go.microsoft.com/fwlink/?LinkId=142331

Connect-WSMan

Disable-WSManCredSSP

Disconnect-WSMan

Enable-WSManCredSSP

Get-WSManCredSSP

Get-WSManInstance

Invoke-WSManAction

New-WSManInstance

Remove-WSManInstance

Set-WSManInstance

Set-WSManQuickConfig

Set-WSManSessionOption

Test-WSMan

PALAVRAS-CHAVE

about_WSMAN about_WinRM