Modifica as informações de gerenciamento relacionadas a um recurso.

Sintaxe

Set-WSManInstance [-ApplicationName <string>] [-ComputerName <string>] [-Fragment <string>] [-Port <int>] [-UseSSL] -ResourceURI <Uri> [[-SelectorSet] <hashtable>] [-Authentication <AuthenticationMechanism>] [-Credential <PSCredential>] [-Dialect <Uri>] [-FilePath <File>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]

Set-WSManInstance [-ConnectionURI <Uri>] [-Fragment <string>] -ResourceURI <Uri> [[-SelectorSet] <hashtable>] [-Authentication <AuthenticationMechanism>] [-Credential <PSCredential>] [-Dialect <Uri>] [-FilePath <File>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]

Descrição

O cmdlet Set-WSManInstance modifica as informações de gerenciamento relacionadas a um recurso.

Este cmdlet usa a camada de conexão/transporte WinRM para modificar as informações.

Parâmetros

-ApplicationName <string>

Especifica o nome do aplicativo na conexão. O valor padrão do parâmetro ApplicationName é "WSMAN". O identificador completo para o ponto de extremidade remoto está no seguinte formato:

<transporte>://<servidor>:<porta>/<NomeAplicativo>

Por exemplo:

http://server01:8080/WSMAN

O IIS (Internet Information Services), que hospeda a sessão, encaminha as solicitações com esse ponto de extremidade ao aplicativo especificado. Esta configuração padrão "WSMAN" é adequada para a maioria dos usos. Este parâmetro foi desenvolvido para ser usado quando vários computadores estabelecem conexões remotas com um computador que executa o Windows PowerShell. Nesse caso, o IIS hospeda o protocolo WS-Management por questões de eficiência.

Necessário?

false

Posição?

named

Valor padrão

wsman

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Authentication <AuthenticationMechanism>

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

- Basic: é um esquema em que o nome de usuário e a senha são enviados como texto não criptografado para o servidor ou o proxy.

- Default: usa o método de autenticação implementado pelo protocolo WS-Management. Este é o padrão.

- Digest: é um esquema de desafio-resposta que usa uma cadeia de caracteres de dados especificada pelo servidor para o desafio.

- Kerberos: o computador cliente e o servidor se autenticam mutuamente usando certificados Kerberos.

- Negotiate: é um esquema desafio-resposta que negocia com o servidor ou o proxy para determinar o esquema a ser usado para autenticação. Por exemplo, o valor desse parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é usado.

- CredSSP: use a autenticação CredSSP (Credential Security Service Provider), que permite ao usuário delegar credenciais. Esta opção é projetada para comandos executados em um computador remoto, mas que coletam dados ou executam comandos adicionais em outros computadores remotos.

Cuidado: o CredSSP delega as credenciais do usuário do computador local para um computador remoto. Essa prática aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, quando as credenciais forem passadas para ele, elas poderão ser usadas para controlar a sessão de rede.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ComputerName <string>

Especifica o computador em relação ao qual você deseja executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, o host local ou um ponto (.) para especificar o computador local. O padrão é o computador local. Quando o computador remoto está em um domínio diferente do usuário, um nome de domínio totalmente qualificado deve ser usado. É possível canalizar um valor para este parâmetro para o cmdlet.

Necessário?

false

Posição?

named

Valor padrão

localhost

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ConnectionURI <Uri>

Especifica o ponto de extremidade da conexão. O formato dessa cadeia de caracteres é:

<Transporte>://<Servidor>:<Porta>/<NomeAplicativo>

A cadeia de caracteres a seguir é um valor formatado corretamente para o parâmetro:

http://Server01:8080/WSMAN

O URI deve ser totalmente qualificado.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Credential <PSCredential>

Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual. Digite um nome de usuário, como "Usuário01", "Domínio01\Usuário01" ou "Usuário@Domínio.com”. Ou insira um objeto PSCredential, como aquele retornado pelo cmdlet Get-Credential. Quando você digitar um nome de usuário, uma senha será solicitada.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Dialect <Uri>

Especifica o dialeto que será usado no predicado de filtragem. Pode ser qualquer dialeto aceito pelo serviço remoto. Os seguintes aliases podem ser usados para o URI do dialeto:

- WQL: https://schemas.microsoft.com/wbem/wsman/1/WQL

- Selector: https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter

- Association: https://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Necessário?

false

Posição?

named

Valor padrão

https://schemas.microsoft.com/wbem/wsman/1/WQL

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-FilePath <File>

Especifica o caminho de um arquivo usado para atualizar um recurso de gerenciamento. Especifique o recurso de gerenciamento usando os parâmetros ResourceURI e SelectorSet. Por exemplo, o seguinte comando usa 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 de spooler usando a entrada de um arquivo. O arquivo, Input.xml, tem o seguinte conteúdo:

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Fragment <string>

Especifica uma seção na instância que será atualizada ou recuperada para a operação fornecida. Por exemplo, para obter o status de um serviço spooler, especifique "-Fragment Status".

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-OptionSet <hashtable>

Passa um conjunto de opções para um serviço, de modo a modificar ou refinar a natureza da solicitação. Essas opções são semelhantes às usadas em shells de linha de comando por serem específicas ao serviço. Qualquer quantidade de opções pode ser especificada.

O exemplo a seguir demonstra a sintaxe para passar os valores 1, 2 e 3 para os três parâmetros a, b e c:

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

Necessário?

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Port <int>

Especifica a porta que será usada quando o cliente se conectar ao serviço WinRM. Quando o transporte for HTTP, a porta padrão será 80. Quando o transporte for HTTPS, a porta padrão será 443. Quando você usar HTTPS como transporte, o valor do parâmetro ComputerName deverá corresponder ao CN (nome comum) do certificado de 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 precisará coincidir como o nome do host do servidor. O parâmetro SkipCNCheck deve ser usado somente por máquinas confiáveis.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ResourceURI <Uri>

Contém o URI da classe ou instância de recursos. O URI é usado para identificar um tipo de recurso específico, como discos ou processos, em um computador.

Um URI consiste em um prefixo e um caminho de um recurso. Por exemplo:

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

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

Necessário?

true

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-SelectorSet <hashtable>

Especifica um conjunto de pares de valores que são usados para selecionar instâncias de recursos de gerenciamento específicas. O parâmetro SelectorSet é usado quando existe mais de uma instância do recurso. O valor do parâmetro SelectorSet deve ser uma tabela de hash. O exemplo a seguir mostra como inserir um valor para o parâmetro:

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

Necessário?

false

Posição?

2

Valor padrão

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-SessionOption <hashtable>

Define um conjunto de opções estendidas para a sessão WS-Management. Digite um objeto SessionOption que você cria usando o cmdlet New-WSManSessionOption. Para obter mais informações sobre as opções disponíveis, consulte New-WSManSessionOption.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-UseSSL

Especifica que o protocolo SSL deve ser usado para estabelecer uma conexão com o computador remoto. Por padrão, SSL não é usado.

O WS-Management criptografa todo o conteúdo do Windows PowerShell transmitido pela rede. O parâmetro UseSSL permite especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta usada para a conexão e você especificar esse parâmetro, o comando falhará.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ValueSet <hashtable>

Especifica uma tabela de hash que ajuda a modificar um recurso de gerenciamento. Especifique o recurso de gerenciamento usando os parâmetros ResourceURI e SelectorSet. O valor do parâmetro ValueSet deve ser uma tabela de hash.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

None

Este cmdlet não aceita entrada.

Saídas

None

Este cmdlet não gera saída.

Exemplo 1

C:\PS>set-wsmaninstance -resourceuri winrm/config/listener -selectorset @{address="*";transport="https"} -valueset @{Enabled="false"}

cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

Descrição
-----------
Este comando desabilita o ouvinte HTTPS no computador local.

Importante: o parâmetro ValueSet diferencia maiúsculas e minúsculas ao fazer a correspondência das propriedades especificadas.  

Por exemplo, usando o comando acima. 

Isto falhará:     -ValueSet @{enabled="False"}

Isto terá êxito:  -ValueSet @{Enabled="False"}






Exemplo 2

C:\PS>set-wsmaninstance -resourceuri winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : https://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

Descrição
-----------
Este comando define o valor MaxEnvelopeSizekb como 200 no computador local.

Importante: o parâmetro ValueSet diferencia maiúsculas e minúsculas ao fazer a correspondência das propriedades especificadas.  

Por exemplo, usando o comando acima. 

Isto falhará:     -ValueSet @{MaxEnvelopeSizeKB ="200"}

Isto terá êxito:  -ValueSet @{MaxEnvelopeSizekb ="200"}






Exemplo 3

C:\PS>set-wsmaninstance -resourceuri winrm/config/listener -computername SERVER02 -selectorset @{address="*";transport="https"} -valueset @{Enabled="false"}

cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

Descrição
-----------
Este comando desabilita o ouvinte HTTPS no computador remoto SERVER02.

Importante: o parâmetro ValueSet diferencia maiúsculas e minúsculas ao fazer a correspondência das propriedades especificadas.  

Por exemplo, usando o comando acima. 

Isto falhará:     -ValueSet @{enabled="False"}

Isto terá êxito:  -ValueSet @{Enabled="False"}






See Also




Sumário