New-PSSessionOption

Syntax

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Beschreibung

Das New-PSSessionOption Cmdlet erstellt ein Objekt, das erweiterte Optionen für eine vom Benutzer verwaltete Sitzung (PSSession) enthält. Sie können das Objekt als Wert des SessionOption-Parameters von Cmdlets verwenden, die eine PSSession erstellen, z New-PSSession. B. , Enter-PSSessionund Invoke-Command.

Ohne Parameter generiert ein Objekt, New-PSSessionOption das die Standardwerte für alle Optionen enthält. Da jede Eigenschaft bearbeitet werden kann, können Sie das resultierende Objekt als Vorlage verwenden und Standardoptionsobjekte für Ihr Unternehmen erstellen.

Sie können ein SessionOption-Objekt auch in der Einstellungsvariable $PSSessionOption speichern. Die Werte dieser Variablen richten neue Standardwerte für die Sitzungsoptionen ein. Sie sind wirksam, wenn keine Sitzungsoptionen für die Sitzung festgelegt werden und sie Vorrang vor den in der Sitzungskonfiguration festgelegten Optionen haben, aber Sie können sie überschreiben, indem Sie Sitzungsoptionen oder ein SessionOption-Objekt in einem Cmdlet angeben, das eine Sitzung erstellt. Weitere Informationen zur Einstellungsvariablen $PSSessionOption finden Sie unter about_Preference_Variables.

Wenn Sie ein SessionOption-Objekt in einem Cmdlet verwenden, das eine Sitzung erstellt, haben die Sitzungsoptionswerte Vorrang vor Standardwerten für Sitzungen, die in der $PSSessionOption Einstellungsvariable und in der Sitzungskonfiguration festgelegt sind. Allerdings haben sie nicht Vorrang vor Höchstwerten, Kontingenten oder Grenzwerten, die in der Sitzungskonfiguration festgelegt sind. Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.

Beispiele

Beispiel 1: Erstellen einer Standardsitzungsoption

Mit diesem Befehl wird ein SessionOption-Objekt mit den Standardwerten erstellt.

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

Beispiel 2: Konfigurieren einer Sitzung mithilfe eines Sitzungsoptionsobjekts

In diesem Beispiel wird gezeigt, wie Ein SessionOption-Objekt zum Konfigurieren einer Sitzung verwendet wird.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

Der erste Befehl erstellt ein neues SessionOption-Objekt und speichert es im Wert der $pso Variablen. Der zweite Befehl verwendet das New-PSSession Cmdlet zum Erstellen einer Sitzung auf dem Remotecomputer Server01. Der Befehl verwendet das SessionOption -Objekt im Wert der $pso Variablen als Wert des SessionOption-Parameters des Befehls.

Beispiel 3: Starten einer interaktiven Sitzung

Dieser Befehl verwendet das Enter-PSSession Cmdlet, um eine interaktive Sitzung mit dem Server01-Computer zu starten.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

Der Wert des SessionOption-Parameters ist ein New-PSSessionOption Befehl mit den Parametern NoEncryption und NoCompression .

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

Beispiel 4: Ändern eines Sitzungsoptionsobjekts

In diesem Beispiel wird veranschaulicht, dass Sie das SessionOption-Objekt ändern können. Alle Eigenschaften verfügen über Lese-/Schreibwerte.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$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

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

Beispiel 5: Erstellen einer Einstellungsvariable

Mit diesem Befehl wird eine $PSSessionOption Einstellungsvariable erstellt.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Wenn die $PSSessionOption Einstellungsvariable in der Sitzung festgelegt wird, werden Standardwerte für Optionen in den Sitzungen festgelegt, die mit den New-PSSessionCmdlets erstellt Enter-PSSessionInvoke-Command werden.

Um die $PSSessionOption Variable in allen Sitzungen verfügbar zu machen, fügen Sie sie ihrer PowerShell-Sitzung und Ihrem PowerShell-Profil hinzu.

Weitere Informationen zur Einstellungsvariablen $PSSessionOption finden Sie unter about_Preference_Variables. Weitere Informationen zu Profilen finden Sie unter about_Profiles.

Beispiel 6: Erfüllen der Anforderungen für eine Remotesitzungskonfiguration

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

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

Der erste Befehl verwendet das New-PSSessionOption Cmdlet zum Erstellen eines SessionOption-Objekts mit der SkipCNCheck-Eigenschaft . Der Befehl speichert das resultierende Sitzungsobjekt in der $skipCN Variablen.

Der zweite Befehl verwendet das New-PSSession Cmdlet, um eine neue Sitzung auf einem Remotecomputer zu erstellen. Die $skipCN Prüfvariable wird im Wert des SessionOption-Parameters verwendet.

Da der Computer durch seine IP-Adresse identifiziert wird, entspricht der Wert des Parameters "ComputerName " keinem der allgemeinen Namen im Zertifikat, das für Secure Sockets Layer (SSL) verwendet wird. Daher ist die SkipCNCheck-Option erforderlich.

Beispiel 7: Bereitstellen von Argumenten für eine Remotesitzung

In diesem Beispiel wird gezeigt, wie Sie den ApplicationArguments-Parameter des New-PSSessionOption Cmdlets verwenden, um der Remotesitzung zusätzliche Daten zur Verfügung zu stellen.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

Der erste Befehl erstellt eine Hashtabelle mit zwei Tasten, Team und Verwendung. Der Befehl speichert die Hashtabelle in der $team Variablen. Weitere Informationen zu Hashtabellen finden Sie unter about_Hash_Tables (Informationen zu Hashtabellen).

Als Nächstes erstellt das New-PSSessionOption Cmdlet unter Verwendung des ApplicationArguments-Parameters ein SessionOption-Objekt , das in der $team Variablen gespeichert ist. Wenn New-PSSessionOption das Sitzungsoptionsobjekt erstellt wird, konvertiert es automatisch die Hashtabelle im Wert des ApplicationArguments-Parameters in ein PrimitiveDictionary , sodass die Daten zuverlässig an die Remotesitzung übertragen werden können.

Das New-PSSession Cmdlet startet eine Sitzung auf dem Server01-Computer. Er verwendet den SessionOption-Parameter , um die Optionen in die $teamOption Variable einzuschließen.

Das Invoke-Command Cmdlet veranschaulicht, dass die Daten in der $team Variablen für Befehle in der Remotesitzung verfügbar sind. Die Daten werden in der ApplicationArguments-Eigenschaft der $PSSenderInfo automatischen Variablen angezeigt.

Das Letzte Invoke-Command zeigt, wie die Daten verwendet werden können.

Parameter

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

PSSessionOption

Hinweise

Wenn der Parameter SessionOption nicht in einem Befehl zum Erstellen einer PSSession verwendet wird, werden die Sitzungsoptionen durch die Eigenschaftswerte der $PSSessionOption Einstellungsvariablen bestimmt, falls sie festgelegt ist. Weitere Informationen zur Variable $PSSessionOption finden Sie unter about_Preference_Variables.

Die Eigenschaften eines Sitzungskonfigurationsobjekts weichen hinsichtlich der für die Sitzungskonfiguration festgelegten Optionen sowie der Werte dieser Optionen ab. Sitzungskonfigurationen, die eine Sitzungskonfigurationsdatei verwenden, haben außerdem zusätzliche Eigenschaften.

Ähnliche Themen

• Enter-PSSession
• Invoke-Command
• New-PSSession