Set-WSManInstance
Modifica as informações de gerenciamento que estão relacionadas a um recurso.
Syntax
Set-WSManInstance
[-ApplicationName <String>]
[-ComputerName <String>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Set-WSManInstance
[-ConnectionURI <Uri>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-SessionOption <SessionOption>]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Set-WSManInstance
cmdlet modifica as informações de gerenciamento relacionadas a um recurso.
Esse cmdlet usa a camada de conexão/transporte do WinRM para modificar as informações.
Exemplos
Exemplo 1: Desabilitar um ouvinte no computador local
Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : http://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...}
Esse comando desabilita o ouvinte HTTPS no computador local.
Importante
O parâmetro ValueSet diferencia maiúsculas de minúsculas ao corresponder às propriedades especificadas.
Por exemplo, neste comando,
Isso falha: -ValueSet @{enabled="False"}
Isso é bem-sucedido: -ValueSet @{Enabled="False"}
Exemplo 2: definir o tamanho máximo do envelope no computador local
Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}
cfg : http://schemas.microsoft.com/wbem/wsman/1/config
lang : en-US
MaxEnvelopeSizekb : 200
MaxTimeoutms : 60000
MaxBatchItems : 32000
MaxProviderRequests : 4294967295
Client : Client
Service : Service
Winrs : Winrs
Esse comando define o valor MaxEnvelopeSizekb como 200 no computador local.
Importante
O parâmetro ValueSet diferencia maiúsculas de minúsculas ao corresponder às propriedades especificadas.
Por exemplo, usando o comando acima.
Isso falha: -ValueSet @{MaxEnvelopeSizeKB ="200"}
Isso é bem-sucedido: -ValueSet @{MaxEnvelopeSizekb ="200"}
Exemplo 3: Desabilitar um ouvinte em um computador remoto
Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : http://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...}
Esse comando desabilita o ouvinte HTTPS no computador remoto SERVER02.
Importante
O parâmetro ValueSet diferencia maiúsculas de minúsculas ao corresponder às propriedades especificadas.
Por exemplo, usando o comando acima.
Isso falha: -ValueSet @{enabled="False"}
Isso é bem-sucedido: -ValueSet @{Enabled="False"}
Parâmetros
-ApplicationName
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 é no seguinte formato:
<transport>://<server>:<port>/<ApplicationName>
Por exemplo:
http://server01:8080/WSMAN
Os Serviços de Informações da Internet (IIS), que hospedam a sessão, encaminham solicitações com esse ponto de extremidade para o aplicativo especificado. Essa configuração padrão de WSMAN
é apropriada para a maioria dos usos. Esse parâmetro é projetado para ser utilizado quando diversos computadores estabelecem conexões remotas com um computador que esteja executando o Windows PowerShell. Nesse caso, o IIS hospeda serviços Web para gerenciamento (WS-Management) para eficiência.
Type: | String |
Position: | Named |
Default value: | Wsman |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Especifica o mecanismo de autenticação a ser usado no servidor. Os valores possíveis são:
Basic
: Básico é um esquema no qual o nome de usuário e a senha são enviados em texto claro para o servidor ou proxy.Default
: use o método de autenticação implementado pelo protocolo WS-Management. Esse é o padrão.Digest
: 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
: Negotiate é um esquema de desafio-resposta que negocia com o servidor ou proxy para determinar o esquema a ser usado para autenticação. Por exemplo, esse valor de parâmetro permite uma negociação para determinar se o protocolo Kerberos ou NTLM será utilizado.CredSSP
: use a autenticação CredSSP (Provedor de Suporte de Segurança de Credencial), que permite ao usuário delegar credenciais. Esta opção foi criada para os comandos executados em um computador remoto, mas 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, no momento em que as credenciais forem passadas a ele essas credenciais poderão ser usadas para controlar a sessão de rede.
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Especifica o certificado de chave pública digital (X509) de uma conta de usuário com permissão para executar essa ação. Insira a impressão digital do certificado.
Os certificados são utilizados na autenticação baseada em certificado do cliente. Eles podem ser mapeados somente para contas de usuário local; eles não funcionam com contas de domínio.
Para obter uma impressão digital do certificado, use o Get-Item
comando ou Get-ChildItem
na unidade do PowerShell Cert:
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Especifica o computador no qual se 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, localhost
ou um ponto (.
) para especificar o computador local. O computador local é o padrão.
Quando o computador remoto estiver em um domínio diferente do usuário, você deverá usar um nome de domínio totalmente qualificado. É possível redirecionar um valor desse parâmetro para o cmdlet.
Type: | String |
Aliases: | cn |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionURI
Especifica o ponto de extremidade de conexão. O formato dessa cadeia de caracteres é:
<Transport>://<Server>:<Port>/<ApplicationName>
A seguinte cadeia de caracteres é um valor formatado corretamente para este parâmetro:
http://Server01:8080/WSMAN
O URI deve ser totalmente qualificado.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica uma conta de usuário que tem permissão para executar esta ação. O padrão é o usuário atual. Digite um nome de usuário, como User01
, Domain01\User01
ou User@Domain.com
. Como alternativa, insira um objeto PSCredential , como um retornado pelo Get-Credential
cmdlet . Quando você digitar um nome de usuário, uma senha será solicitada.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Dialect
Especifica o dialeto a ser usado no predicado de filtro. Isso pode ser qualquer dialeto compatível com o serviço remoto. Os seguintes aliases podem ser usados para o URI do dialeto:
WQL
:http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector
:http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Association
:http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Type: | Uri |
Position: | Named |
Default value: | http://schemas.microsoft.com/wbem/wsman/1/WQL |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Especifica o caminho de um arquivo usado para atualizar um recurso de gerenciamento. Especifique o recurso de gerenciamento usando o parâmetro ResourceURI e o parâmetro 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
Esse comando chama o método StopService no serviço Spooler usando a entrada de um arquivo.
O arquivo, Input.xml
, contém o seguinte conteúdo:
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
Type: | String |
Aliases: | Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Fragment
Especifica uma seção na instância a ser atualizada ou recuperada para a operação especificada. Por exemplo, para obter o status de um serviço spooler, especifique -Fragment Status
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionSet
Passa um conjunto de opções para um serviço para modificar ou refinar a natureza da solicitação. Elas são semelhantes às opções usadas nos shells de linha de comando porque são específicas para o serviço. Qualquer número de opções pode ser especificado.
O exemplo a seguir demonstra a sintaxe que passa os valores 1
, 2
e 3
para os a
parâmetros , b
e c
:
-OptionSet @{a=1;b=2;c=3}
Type: | Hashtable |
Aliases: | os |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Especifica a porta a ser usada quando o cliente se conecta ao serviço WinRM. Quando o transporte é HTTP, a porta padrão é 80. Quando o transporte é HTTPS, a porta padrão é 443.
Quando você usa HTTPS como transporte, o valor do parâmetro ComputerName deve corresponder ao CN (nome comum) 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 precisará corresponder ao nome do host do servidor. O parâmetro SkipCNCheck deve ser usado apenas para computadores confiáveis.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceURI
Contém o Uniform Resource Identifier (URI) da instância ou classe do recurso. O URI é utilizado para identificar um tipo específico de recurso, como discos ou processos em um computador.
Um URI consiste em um prefixo e um 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
Type: | Uri |
Aliases: | ruri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SelectorSet
Especifica um conjunto de pares de valor que são utilizados para selecionar instâncias do recurso de gerenciamento específico. O parâmetro SelectorSet é usado quando há 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 esse parâmetro:
-SelectorSet @{Name="WinRM";ID="yyy"}
Type: | Hashtable |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
Define um conjunto de opções estendidas para a sessão do WS-Management. Insira um objeto SessionOption criado com o New-WSManSessionOption
cmdlet . Para obter mais informações sobre as opções disponíveis, consulte New-WSManSessionOption.
Type: | SessionOption |
Aliases: | so |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Especifica que o protocolo Secure Sockets Layer (SSL) deve ser utilizado 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 que é 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 utilizada para a conexão e o parâmetro for especificado, o comando falhará.
Type: | SwitchParameter |
Aliases: | ssl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueSet
Especifica uma tabela de hash que ajuda a modificar um recurso de gerenciamento. Especifique o recurso de gerenciamento usando o parâmetro ResourceURI e o parâmetro SelectorSet . O valor do parâmetro ValueSet deve ser uma tabela de hash.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
None
Esse cmdlet não aceita nenhuma entrada.
Saídas
None
Este cmdlet não gera saída.