New-PSSessionOption

New-PSSessionOption [-ApplicationArguments <PSPrimitiveDictionary>] [-CancelTimeOut <int>] [-Culture <CultureInfo>] [-IdleTimeOut <int>] [-MaximumReceivedDataSizePerCommand <int>] [-MaximumReceivedObjectSize <int>] [-MaximumRedirection <int>] [-NoCompression] [-NoEncryption] [-NoMachineProfile] [-OpenTimeOut <int>] [-OperationTimeOut <int>] [-ProxyAccessType {<None> | <IEConfig> | <WinHttpConfig> | <AutoDetect> | <NoProxyServer>}] [-ProxyAuthentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ProxyCredential <PSCredential>] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-UICulture <CultureInfo>] [-UseUTF16] [<CommonParameters>]

C:\PS>New-PSSessionOption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Descrição
-----------
Esse comando cria um objeto de opção de sessão com todos os valores padrão.

C:\PS>$pso = new-pssessionoption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB

C:\PS> new-pssession -computerName Server01 -SessionOption $pso

Descrição
-----------
Este exemplo mostra como usar um objeto de opção de sessão para configurar uma sessão.

O primeiro comando cria um novo objeto de opção de sessão e salva-o no valor da variável $pso.

O segundo comando usa o cmdlet New-PSSession para criar uma PSSession no computador remoto Server01. O comando usa o novo objeto de opção de sessão no valor da variável $pso como o valor do parâmetro SessionOption do comando.

C:\PS>enter-pssession -computername Server01 -sessionOption (new-pssessionoption -noEncryption -noCompression)

Descrição
-----------
Esse comando usa o cmdlet Enter-PSSession para iniciar uma sessão interativa com o computador Server01. O valor do parâmetro SessionOption é um comando New-PSSessionOption com os parâmetros de opção NoEncryption e NoCompression.

O comando New-PSSessionOption é colocado entre parênteses para garantir que seja executado antes do comando Enter-PSSession.

C:\PS>$a = new-pssessionoption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

C:\PS> $a.UICulture = (get-UICulture)
C:\PS> $a.OpenTimeout = (new-timespan -minutes 4)
C:\PS> $a.MaximumConnectionRedirectionCount = 1

C:\PS> $a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Descrição
-----------
Este exemplo demonstra que você pode editar o objeto de opção de sessão. Todas as propriedades têm valores de leitura/gravação.

Use este método para criar um objeto de sessão padrão para sua empresa e, em seguida, crie versões personalizadas dele para usos específicos.

C:\PS>$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Descrição
-----------
Esse comando cria uma variável de preferência $PSSessionOption. 

Quando a variável de preferência $PSSessionOption existir na sessão, ela estabelecerá valores padrão para opções nas PSSessions criadas com os cmdlets New-PSSession, Enter-PSSession e Invoke-Command.

Para tornar a variável $PSSessionOption disponível em todas as sessões, adicione-a à sua sessão do Windows PowerShell e ao seu perfil do Windows PowerShell.

Para obter mais informações sobre a variável $PSSessionOption, consulte about_Preference_Variables. Para obter mais informações sobre perfis, consulte about_Profiles.

C:\PS>$skipCN = new-pssessionoption -SkipCNCheck

C:\PS> new-pssession -computername 171.09.21.207 -UseSSL -credential domain01\user01 -sessionOption $skipCN

Descrição
-----------
Este exemplo mostra como usar um objeto SessionOption para cumprir os requisitos para uma configuração de sessão remota.

O primeiro comando usa o cmdlet New-PSSessionOption para criar um objeto de opção de sessão com a propriedade SkipCNCheck. O comando salva o objeto de sessão resultante na variável $skipCN.

O segundo comando usa o cmdlet New-PSSession para criar uma nova PSSession em um computador remoto. A variável de verificação $skipCN é usada no valor do parâmetro SessionOption. 

Como o computador é identificado pelo seu endereço IP, o valor do parâmetro ComputerName não corresponde a nenhum dos nomes comuns no certificado usado para SSL. Com isso, a opção SkipCNCheck é necessária.