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

Descrizione
-----------
Questo comando crea un oggetto opzione di sessione con tutti i valori predefiniti.

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

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

Descrizione
-----------
In questo esempio viene illustrato come utilizzare un oggetto opzione di sessione per configurare una sessione.

Con il primo comando un nuovo oggetto opzione di sessione viene creato e salvato nel valore della variabile $pso.

Nel secondo comando viene utilizzato il cmdlet New-PSSession per creare una sessione PSSession nel computer remoto Server01. L'oggetto opzione di sessione nel valore della variabile $pso viene utilizzato come valore del parametro SessionOption del comando.

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

Descrizione
-----------
In questo comando viene utilizzato il cmdlet Enter-PSSession per avviare una sessione interattiva con il computer Server01. Il valore del parametro SessionOption è un comando New-PSSessionOption con i parametri opzionali NoEncryption e NoCompression.

Il comando New-PSSessionOption è racchiuso tra parentesi per garantire che venga eseguito prima del 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

Descrizione
-----------
In questo esempio viene illustrato che è possibile modificare l'oggetto opzione di sessione. Tutte le proprietà hanno valori di lettura/scrittura.

Utilizzare questo metodo per creare un oggetto sessione standard per l'organizzazione, quindi creare versioni personalizzate di tale oggetto per utilizzi specifici.

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

Descrizione
-----------
Questo comando crea una variabile di preferenza $PSSessionOption. 

Quando la variabile di preferenza $PSSessionOption è presente nella sessione, stabilisce valori predefiniti per le opzioni nelle sessioni PSSession create utilizzando i cmdlet New-PSSession, Enter-PSSession e Invoke-Command.

Per rendere disponibile in tutte le sessioni la variabile $PSSessionOption, aggiungerla alla sessione e al profilo di Windows PowerShell.

Per ulteriori informazioni sulla variabile di preferenza $PSSessionOption, vedere about_Preference_Variables. Per ulteriori informazioni sui profili, vedere about_Profiles.

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

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

Descrizione
-----------
In questo esempio viene illustrato come utilizzare un oggetto SessionOption per soddisfare i requisiti per la configurazione di una sessione remota.

Il primo comando utilizza il cmdlet New-PSSessionOption per creare un oggetto opzione di sessione con la proprietà SkipCNCheck. L'oggetto sessione risultante viene salvato nella variabile $skipCN.

Nel secondo comando viene utilizzato il cmdlet New-PSSession per creare una nuova sessione PSSession in un computer remoto. La variabile di controllo $skipCN viene utilizzata nel valore del parametro SessionOption. 

Poiché il computer viene identificato in base all'indirizzo IP, il valore del parametro ComputerName non corrisponde ad alcun nome comune nel certificato utilizzato per Secure Sockets Layer (SSL). Di conseguenza, è obbligatoria l'opzione SkipCNCheck.