Invoke-WSManAction

Especifica o método a executar no objeto de gestão especificado pelo ResourceURI e pelos seletores.

Especifica o nome da aplicação na ligação. O valor predefinido do parâmetro ApplicationName é WSMAN. O identificador completo do ponto final remoto está no seguinte formato:

<Transport>://<Server>:<Port>/<ApplicationName>

Por exemplo:

http://server01:8080/WSMAN

Os Serviços de Informação Internet (IIS), que aloja a sessão, reencaminham os pedidos com este ponto final para a aplicação especificada. Esta predefinição de "WSMAN" é adequada para a maioria das utilizações. Este parâmetro foi concebido para ser utilizado quando vários computadores estabelecem ligações remotas a um computador com Windows PowerShell. Neste caso, o IIS aloja os Serviços Web para Gestão (WS-Management) para eficiência.

Especifica o mecanismo de autenticação a ser utilizado no servidor. Os valores possíveis são:

• Basic - Básico é um esquema no qual o nome de utilizador e a palavra-passe são enviados em texto não encriptado para o servidor ou proxy.
• Default - Utilize o método de autenticação implementado pelo protocolo WS-Management. Esta é a predefinição.
• Digest - Resumo é um esquema de resposta a desafios que utiliza uma cadeia de dados especificada pelo servidor para o desafio.
• Kerberos - O computador cliente e o servidor autenticam-se mutuamente através de certificados Kerberos.
• Negotiate - Negociar é um esquema de resposta a desafios que negoceia com o servidor ou proxy para determinar o esquema a utilizar para autenticação. Por exemplo, este valor de parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é utilizado.
• CredSSP - Utilize a autenticação do Fornecedor de Suporte de Segurança de Credenciais (CredSSP), que permite ao utilizador delegar credenciais. Esta opção foi concebida para comandos executados num computador remoto, mas que recolhem dados ou executam comandos adicionais noutros computadores remotos.

Especifica o certificado de chave pública digital (X509) de uma conta de utilizador que tem permissão para efetuar esta ação. Introduza o thumbprint do certificado.

Os certificados são utilizados na autenticação baseada em certificados de cliente. Só podem ser mapeadas para contas de utilizador locais; não funcionam com contas de domínio.

Para obter um thumbprint de certificado, utilize o Get-Item comando ou Get-ChildItem na unidade Windows PowerShell Cert: .

Especifica o computador no qual pretende executar a operação de gestão. O valor pode ser um nome de domínio completamente qualificado, um nome NetBIOS ou um endereço IP. Utilize o nome do computador local, utilize localhost ou utilize um ponto (.) para especificar o computador local. O computador local é a predefinição. Quando o computador remoto está num domínio diferente do utilizador, tem de utilizar um nome de domínio completamente qualificado. Pode encaminhar um valor para este parâmetro para o cmdlet .

Especifica o ponto final de ligação. O formato desta cadeia é:

<Transport>://<Server>:<Port>/<ApplicationName>

A cadeia seguinte é um valor formatado corretamente para este parâmetro:

http://Server01:8080/WSMAN

O URI tem de estar completamente qualificado.

Especifica uma conta de utilizador com permissão para efetuar esta ação. A predefinição é o utilizador atual. Escreva um nome de utilizador, como "Utilizador01", "Domínio01\Utilizador01" ou User@Domain.com. Em alternativa, introduza um objeto PSCredential, como um devolvido pelo Get-Credential cmdlet . Quando escreve um nome de utilizador, ser-lhe-á pedida uma palavra-passe.

Especifica o caminho de um ficheiro que é utilizado para atualizar um recurso de gestão. Especifique o recurso de gestão com o parâmetro ResourceURI e o parâmetro SelectorSet. Por exemplo, o seguinte comando utiliza o parâmetro FilePath:

Invoke-WSManAction -Action stopservice -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath c:\input.xml -Authentication default

Este comando chama o método StopService no serviço Spooler através da entrada de um ficheiro. O ficheiro , Input.xmlcontém o seguinte conteúdo:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Transmite um conjunto de comutadores para um serviço para modificar ou refinar a natureza do pedido. Estes parâmetros são semelhantes aos comutadores utilizados em shells de linha de comandos porque são específicos do serviço. Qualquer número de opções pode ser especificado.

O exemplo seguinte demonstra a sintaxe que transmite os valores 1, 2 e 3 para os parâmetros a, b e c:

-OptionSet @{a=1;b=2;c=3}

Especifica a porta a utilizar quando o cliente se ligar ao serviço WinRM. Quando o transporte é HTTP, a porta predefinida é 80. Quando o transporte é HTTPS, a porta predefinida é 443. Quando utiliza HTTPS como transporte, o valor do parâmetro ComputerName tem de corresponder ao nome comum (CN) do certificado do servidor. No entanto, se o parâmetro SkipCNCheck for especificado como parte do parâmetro SessionOption, o nome comum do certificado do servidor não tem de corresponder ao nome do anfitrião do servidor. O parâmetro SkipCNCheck deve ser utilizado apenas para computadores fidedignos.

Contém o Uniform Resource Identifier (URI) da classe de recursos ou instância. O URI é utilizado para identificar um tipo específico de recurso, como discos ou processos, num computador.

Um URI consiste num prefixo e num caminho para um recurso. Por exemplo:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Especifica um conjunto de pares de valores que são utilizados para selecionar instâncias de recursos de gestão específicas. SelectorSet é utilizado quando existe mais do que uma instância do recurso. O valor de SelectorSet tem de ser uma tabela hash.

O exemplo seguinte mostra como introduzir um valor para este parâmetro:

-SelectorSet @{Name="WinRM";ID="yyy"}

Define um conjunto de opções expandidas para a sessão de WS-Management. Introduza um objeto SessionOption que criar com o New-WSManSessionOption cmdlet . Para obter mais informações sobre as opções disponíveis, consulte New-WSManSessionOption.

Especifica que o protocolo SSL (Secure Sockets Layer) é utilizado para estabelecer uma ligação ao computador remoto. Por predefinição, o SSL não é utilizado.

WS-Management encripta todo o conteúdo do PowerShell que é transmitido através da rede. O parâmetro UseSSL permite-lhe especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta utilizada para a ligação e especificar este parâmetro, o comando falhará.

Especifica uma tabela hash que ajuda a modificar um recurso de gestão. Especifique o recurso de gestão com os parâmetros ResourceURI e SelectorSet . O valor do parâmetro ValueSet tem de ser uma tabela hash.