New-WSManSessionOption
Cria uma tabela de hash de opção de sessão para usar como parâmetros de entrada para cmdlets WS-Management.
Sintaxe
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>] Description
Esse cmdlet só está disponível na plataforma Windows.
O New-WSManSessionOption cmdlet cria uma tabela de hash de opção WSMan Session que pode ser passada para cmdlets WSMan:
Get-WSManInstanceSet-WSManInstanceInvoke-WSManActionConnect-WSMan
Exemplos
Exemplo 1: Criar uma conexão que usa 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 ContainerEste exemplo cria uma conexão com o computador server01 remoto usando as opções de conexão definidas pelo New-WSManSessionOption.
O primeiro comando é usado New-WSManSessionOption para armazenar um conjunto de opções de configuração de conexão na $a variável. Nesse caso, as opções da sessão definem um tempo de conexão de 30 segundos (30.000 milissegundos).
O segundo comando usa o parâmetro SessionOption para passar as credenciais armazenadas na $a variável para Connect-WSMan. Em seguida, Connect-WSMan conecta-se ao computador servidor remoto01 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.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OperationTimeout
Especifica o tempo limite, em milissegundos, para a operação WS-Management.
| Tipo: | Int32 |
| Aliases: | OperationTimeoutMSec |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProxyAccessType
Especifica o mecanismo pelo qual o servidor proxy é localizado. Os valores aceitáveis para esse 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 definidas 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.
| Tipo: | ProxyAccessType |
| Valores aceitos: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProxyAuthentication
Especifica o método de autenticação a ser usado no proxy. Os valores aceitáveis para esse parâmetro são:
Basic- Básico é um esquema no qual o nome de usuário e a senha são enviados em texto não criptografado 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. Os exemplos são o protocolo Kerberos e NTLM.
O valor padrão é Negociar.
| Tipo: | ProxyAuthentication |
| Valores aceitos: | Negotiate, Basic, Digest |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProxyCredential
Especifica uma conta de usuário que tem permissão para obter acesso por meio de um proxy da Web intermediário.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipCACheck
Especifica que, quando ele se conecta por HTTPS, o cliente não valida se o certificado do servidor é assinado por uma autoridade de certificação (CA) 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 do WS-Management.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipCNCheck
Especifica que o CN (nome comum) do certificado do servidor não precisa corresponder ao nome do host do servidor. É usado somente em operações remotas usando HTTPS. Essa opção deve ser usada somente para computadores confiáveis.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipRevocationCheck
Indica que a conexão não valida o status de revogação no certificado do servidor.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SPNPort
Especifica um número de porta a ser acrescentado ao SPN (Nome da Entidade de Serviço) da conexão do servidor remoto. Um SPN é usado quando o mecanismo de autenticação é Kerberos ou Negotiate.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
Esse cmdlet retorna a opção de sessão WSMan criada como um objeto SessionOption .
