TOPIC

about_WS-Management_Cmdlets

SHORT DESCRIPTION
Provides an overview of Web Services for Management (WS
-Management) as background for using the WS-Management cmdlets
in Windows PowerShell.

LONG DESCRIPTION
This topic provides an overview of Web Services for Management (WS-Management)
as background for using the WS-Management cmdlets in Windows
PowerShell. This topic also provides links to more information
about WS-Management. The Microsoft implementation of WS
-Management is also known as Windows Remote Management (WinRM).

Sobre WS-Management

O WinRM é a implementação do protocolo WS-Management da

Microsoft, um protocolo de comunicação padrão compatível com
firewall e baseado no SOAP que permite que o hardware e os
sistemas operacionais de diferentes fornecedores interoperem.
A especificação de protocolo WS-Management fornece uma forma
comum para os sistemas de acessar e trocar informações sobre
gerenciamento em uma infraestrutura de TI. WS-Management e
IPMI (Intelligent Platform Management Interface), junto com
Event Collector, 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ços da Web: HTTPS, SOAP em 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 da WMI com scripts ou aplicativos que usam
a API de script do WS-Management ou por meio da ferramenta
de linha de comando do WinRM. O WS-Management fornece suporte
à maioria das classes e operações de WMI conhecidas, incluindo
objetos incorporados. O WS-Management pode aproveitar a 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 na sua empresa por meio do
conjunto de classes existente da WMI. Você também pode acessar
os dados do hardware que estão disponíveis no provedor WMI
IPMI padrão.

Provedor do WS-Management Windows PowerShell

O provedor do WS-Management fornece uma exibição hierárquica nas

definições de configuração disponíveis do WS-Management. 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 ficará
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 WS-Management não poderá executar as operações de dados.
A ferramenta de linha de comando do WS-Management, WinRM,
e o encaminhamento do evento 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 o provedor do WS-Management.
Você pode usar esses cmdlets para concluir completamente as
tarefas que são necessárias para gerenciar configurações do
WS-Management nos computadores local e remoto.

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 de recurso especificada por um URI de recurso.

-- Invoke-WSManAction: chama uma ação no objeto de destino

especificado pelo URI de 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 definiçã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 para
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 listener que aceita solicitações de qualquer endereço

IP. O protocolo de transporte padrão é HTTP.

- Ele habilita uma exceção de firewall para tráfego do WS-Management.

Observação: para executar esse cmdlet no Windows Vista, no Windows

Server 2008 e em versões mais recentes do Windows, inicie 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 as configurações relacionadas ao

CredSSP para o computador cliente.

Cmdlets específicos do WS-Management

-- New-WSManSessionOption: cria um objeto WSManSessionOption para

ser usado como entrada de um ou mais parâmetros do cmdlet do
WS-Management.

Informações adicionais do WS-Management

Para obter mais informações sobre WS-Management, consulte os

tópicos a seguir na biblioteca do MSDN (Microsoft Developer
Network).

"Windows Remote Management"

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

"About Windows Remote Management"

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

"Installation and Configuration for Windows Remote Management"

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

"Windows Remote Management Architecture"

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

"WS-Management Protocol"
http://go.microsoft.com/fwlink/?LinkId=142325

"Windows Remote Management and WMI"

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

"Resource URIs"
 http://go.microsoft.com/fwlink/?LinkId=142327

"Remote Hardware Management"

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

"Events"
http://go.microsoft.com/fwlink/?LinkId=142329

CONSULTE TAMBÉM
Versão online: http://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