Compartilhar via

New-WSManSessionOption

Módulo:
Microsoft.WSMan.Management Module

Cria uma tabela de hash de opção de sessão para usar como parâmetros de entrada para cmdlets WS-Management.

Sintaxe

Default (Padrão) 

New-WSManSessionOption
    [-ProxyAccessType <ProxyAccessType>]
    [-ProxyAuthentication <ProxyAuthentication>]
    [-ProxyCredential <PSCredential>]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-SPNPort <Int32>]
    [-OperationTimeout <Int32>]
    [-NoEncryption]
    [-UseUTF16]
    [<CommonParameters>]

Description

O cmdlet New-WSManSessionOption cria uma tabela de hash de opção de Sessão WSMan que pode ser passada para cmdlets WSMan:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Exemplos

Exemplo 1: criar uma conexão que use opções de conexão

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd WSMan:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Este exemplo cria uma conexão com o computador server01 remoto usando as opções de conexão definidas por New-WSManSessionOption.

O primeiro comando usa New-WSManSessionOption para armazenar um conjunto de opções de configuração de conexão na variável $a. Nesse caso, as opções de sessão definem um tempo limite de conexão de 30 segundos (30.000 milissegundos).

O segundo comando usa o parâmetro SessionOption para passar as credenciais armazenadas na variável $a para Connect-WSMan. Em seguida, Connect-WSMan se conecta ao computador server01 remoto usando as opções de sessão especificadas.

Connect-WSMan geralmente é usado no contexto do provedor WSMan para se conectar a um computador remoto, nesse caso, o computador server01. No entanto, você pode usar o cmdlet para estabelecer conexões com computadores remotos antes de alterar para o provedor WSMan. Essas conexões aparecem na lista ComputerName.

Parâmetros

-NoEncryption

Indica que a conexão não usa criptografia para operações remotas por HTTP.

Por padrão, o tráfego não criptografado não está habilitado. Ele deve ser habilitado na configuração local.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OperationTimeout

Especifica o tempo limite, em milissegundos, para a operação de WS-Management.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:OperationTimeoutMSec

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyAccessType

Especifica o mecanismo pelo qual o servidor proxy está localizado. Os valores aceitáveis para este parâmetro são:

  • ProxyIEConfig – Use a configuração de proxy do Internet Explorer para o usuário atual.
  • ProxyWinHttpConfig - O cliente WSMan usa as configurações de proxy configuradas para WinHTTP usando o utilitário ProxyCfg.exe.
  • ProxyAutoDetect – Forçar a detecção automática de um servidor proxy.
  • ProxyNoProxyServer - Não use um servidor proxy. Resolva todos os nomes de host localmente.

O valor padrão é ProxyIEConfig.

Propriedades do parâmetro

Tipo:ProxyAccessType
Valor padrão:None
Valores aceitos:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyAuthentication

Especifica o método de autenticação a ser usado no proxy. Os valores aceitáveis para este parâmetro são:

  • Basic - Básico é um esquema no qual o nome de usuário e a senha são enviados em texto limpo para o servidor ou proxy.
  • Digest – Digest é um esquema de desafio-resposta que usa uma cadeia de caracteres de dados especificada pelo servidor para o desafio.
  • Negotiate – Negociar é um esquema de desafio-resposta que negocia com o servidor ou proxy para determinar qual esquema usar para autenticação. Exemplos são o protocolo Kerberos e o NTLM.

O valor predefinido é Negociar.

Propriedades do parâmetro

Tipo:ProxyAuthentication
Valor padrão:None
Valores aceitos:Negotiate, Basic, Digest
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyCredential

Especifica uma conta de usuário que tem permissão para obter acesso por meio de um proxy Web intermediário.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipCACheck

Especifica que, quando ele se conecta via HTTPS, o cliente não valida que o certificado do servidor é assinado por uma AC (autoridade de certificação) confiável. Use essa opção somente quando o computador remoto for confiável por outro método, por exemplo, se o computador remoto fizer parte de uma rede fisicamente segura e isolada ou se o computador remoto estiver listado como um host confiável na configuração de WS-Management.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipCNCheck

Especifica que o CN (nome comum do certificado) do servidor não precisa corresponder ao nome do host do servidor. Isso é usado somente em operações remotas usando HTTPS. Essa opção só deve ser usada para computadores confiáveis.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipRevocationCheck

Indica que a conexão não valida o status de revogação no certificado do servidor.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SPNPort

Especifica um número de porta a ser acrescentado ao SPN (Nome da Entidade de Serviço) de conexão do servidor remoto. Um SPN é usado quando o mecanismo de autenticação é Kerberos ou Negotiate.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseUTF16

Indica que a conexão codifica a solicitação no formato UTF16 em vez do formato UTF8. O padrão é a codificação UTF8.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

SessionOption

Esse cmdlet retorna a opção de sessão WSMan criada como um objeto SessionOption.