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

Beschreibung
-----------
Mit diesem Befehl wird ein Sitzungsoptionsobjekt mit allen Standardwerten erstellt.

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

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

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie Sie eine Sitzung mit einem Sitzungsoptionsobjekt konfigurieren.

Mit dem ersten Befehl wird ein neues Sitzungsoptionsobjekt erstellt und im Wert der Variablen "$pso" gespeichert.

Im zweiten Befehl wird mit dem Cmdlet "New-PSSession" eine PSSession auf dem Remotecomputer "Server01" erstellt. Der Befehl verwendet das Sitzungsoptionsobjekt im Wert der Variablen "$pso" als Wert des SessionOption-Parameters des Befehls.

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

Beschreibung
-----------
Dieser Befehl verwendet das Cmdlet "Enter-PSSession", um eine interaktive Sitzung mit dem Computer "Server01" zu starten. Der Wert des SessionOption-Parameters ist ein New-PSSessionOption-Befehl mit dem NoEncryption-Schalterparameter und dem NoCompression-Schalterparameter.

Der Befehl "New-PSSessionOption" wird in Klammern eingeschlossen, um sicherzustellen, dass er vor dem Befehl "Enter-PSSession" ausgeführt wird.

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

Beschreibung
-----------
In diesem Beispiel wird veranschaulicht, wie das Sitzungsoptionsobjekt bearbeitet werden kann. Alle Eigenschaften verfügen über Lese-/Schreibwerte.

Verwenden Sie diese Methode, um ein Standardsitzungsobjekt für Ihr Unternehmen zu erstellen, und dann angepasste Versionen für bestimmte Verwendungszwecke anzulegen.

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

Beschreibung
-----------
Mit diesem Befehl wird die Einstellungsvariable "$PSSessionOption" erstellt. 

Wenn die Einstellungsvariable "$PSSessionOption" in der Sitzung vorhanden ist, legt sie Standardwerte für Optionen in den PSSessions fest, die mit den Cmdlets "New-PSSession", "Enter-PSSession" und "Invoke-Command" erstellt werden.

Damit die Variable "$PSSessionOption" in allen Sitzungen zur Verfügung steht, fügen Sie sie der Windows PowerShell-Sitzung und dem Windows PowerShell-Profil hinzu.

Weitere Informationen über die Einstellungsvariable "$PSSessionOption" finden Sie unter "about_Preference_Variables". Weitere Informationen über Profile finden Sie unter "about_Profiles".

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

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

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie ein SessionOption-Objekt verwendet wird, um die Anforderungen für eine Remotesitzungskonfiguration zu erfüllen.

Der erste Befehl verwendet das Cmdlet "New-PSSessionOption", um ein Sitzungsoptionsobjekt mit der SkipCNCheck-Eigenschaft zu erstellen. Der Befehl speichert das resultierende Sitzungsobjekt in der Variablen "$skipCN".

Der zweite Befehl verwendet das Cmdlet "New-PSSession", um eine neue PSSession auf dem Remotecomputer zu erstellen. Die Variable "$skipCNCheck" wird im Wert des SessionOption-Parameters verwendet. 

Da der Computer von seiner IP-Adresse identifiziert wird, stimmt der Wert des ComputerName-Parameters mit keinem der allgemeinen Namen in dem Zertifikat überein, das für Secure Sockets Layer (SSL) verwendet wird. Deshalb ist die SkipCNCheck-Option erforderlich.