New-PSSessionOption

Syntax

Default (Standard)

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

Beispiele

Beispiel 1: Erstellen einer Standardsitzungsoption

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

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

Beispiel 3: Starten einer interaktiven Sitzung

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

Beispiel 4: Ändern eines Sitzungsoptionsobjekts

$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

Beispiel 5: Erstellen einer Einstellungsvariable

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

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

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

Beispiel 7: Bereitstellen von Argumenten für eine Remotesitzung

$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.

Parameter

-ApplicationArguments

Gibt ein primitives Wörterbuch an, das an die Remotesitzung gesendet wird. Befehle und Skripts in der Remotesitzung, einschließlich Startskripts in der Sitzungskonfiguration, können dieses Wörterbuch in der Eigenschaft ApplicationArguments der automatischen Variablen $PSSenderInfo finden. Sie können diesen Parameter verwenden, um Daten an die Remotesitzung zu senden.

Weitere Informationen finden Sie unter about_Hash_Tables, about_Session_Configurationsund about_Automatic_Variables.

Parametereigenschaften

Parametersätze

-CancelTimeout

Bestimmt, wie lange PowerShell wartet, bis ein Abbruchvorgang (STRG+C) abgeschlossen ist, bevor er beendet wird. Geben Sie einen Wert in Millisekunden ein.

Der Standardwert ist 60000 (eine Minute). Ein Wert von 0 (Null) bedeutet, dass es keine Zeitüberschreitung gibt. Der Befehl wird auf unbestimmte Zeit fortgesetzt.

Parametereigenschaften

Parametersätze

-Culture

Gibt die Kultur an, die für die Sitzung verwendet werden soll. Geben Sie einen Culture-Namen im <languagecode2>-<country/regioncode2>-Format (wie ja-JP), eine Variable, die ein CultureInfo-Objekt enthält, oder einen Befehl ein, der ein CultureInfo-Objekt abruft.

Der Standardwert ist $Null, und die im Betriebssystem festgelegte Culture wird in der Sitzung verwendet.

Parametereigenschaften

Parametersätze

-IdleTimeout

Bestimmt, wie lange die Sitzung geöffnet bleibt, wenn der Remotecomputer keine Kommunikation vom lokalen Computer empfängt. Dazu gehört das Herzfrequenzsignal. Wenn das Intervall abläuft, wird die Sitzung geschlossen.

Der Wert für die Leerlaufzeit ist von großer Bedeutung, wenn Sie beabsichtigen, die Verbindung zu einer Sitzung zu trennen und erneut aufzubauen. Sie können nur dann erneut eine Verbindung herstellen, wenn die Sitzung nicht abgelaufen ist.

Geben Sie einen Wert in Millisekunden ein. Der Mindestwert beträgt 60000 (1 Minute). Der Höchstwert ist der Wert der MaxIdleTimeoutms-Eigenschaft der Sitzungskonfiguration. Der Standardwert -1 legt kein Timeout im Leerlauf fest.

Die Sitzung nutzt, falls vorhanden, das Leerlauf-Zeitlimit, das in den Sitzungsoptionen festgelegt ist. Wenn keiner festgelegt ist (-1), verwendet die Sitzung den Wert der IdleTimeoutMs-Eigenschaft der Sitzungskonfiguration oder den Wert für das Zeitlimit der WSMan-Shell (WSMan:\<ComputerName>\Shell\IdleTimeout), je nachdem, welcher Wert kürzer ist.

Wenn das in den Sitzungsoptionen festgelegte Leerlauftimeout den Wert der MaxIdleTimeoutMs-Eigenschaft der Sitzungskonfiguration überschreitet, schlägt der Befehl zum Erstellen einer Sitzung fehl.

Der IdleTimeoutMs-Wert der standardmäßigen Microsoft.PowerShell-Sitzungskonfiguration beträgt 7200000 Millisekunden (2 Stunden). Der MaxIdleTimeoutMs-Wert beträgt 2147483647 Millisekunden (>24 Tage). Der Standardwert des Leerlauftimeouts der WSMan-Shell (WSMan:\<ComputerName>\Shell\IdleTimeout) beträgt 7200000 Millisekunden (2 Stunden).

Der Wert für das Leerlauf-Timeout einer Sitzung kann auch geändert werden, wenn Sie die Verbindung zu einer Sitzung trennen oder die Verbindung zu einer Sitzung wiederherstellen. Weitere Informationen finden Sie unter Disconnect-PSSession und Connect-PSSession.

In Windows PowerShell 2.0 ist der Standardwert des IdleTimeout-Parameters 240000 (4 Minuten).

Parametereigenschaften

Parametersätze

-IncludePortInSPN

Enthält die Portnummer im Dienstprinzipalnamen (SERVICE Principal Name, SPN), der für die Kerberos-Authentifizierung verwendet wird, z. B. HTTP://<ComputerName>:5985. Diese Option ermöglicht einem Client, der einen nicht standardmäßigen SPN verwendet, um sich bei einem Remotecomputer zu authentifizieren, auf dem die Kerberos-Authentifizierung verwendet wird.

Die Option ist für Unternehmen vorgesehen, bei denen mehrere Dienste, die die Kerberos-Authentifizierung unterstützen, unter verschiedenen Benutzerkonten ausgeführt werden. Eine IIS-Anwendung, die die Kerberos-Authentifizierung zulässt, kann z. B. erfordern, dass der Standard-SPN in einem Benutzerkonto registriert wird, das sich von dem Computerkonto unterscheidet. In solchen Fällen kann PowerShell-Remoting nicht Kerberos zur Authentifizierung verwenden, da es einen SPN benötigt, der für das Computerkonto registriert ist. Um dieses Problem zu beheben, können Administratoren verschiedene SPNs erstellen, z. B. mithilfe von Setspn.exe, die bei unterschiedlichen Benutzerkonten registriert sind, und zwischen ihnen unterscheiden, indem sie die Portnummer in den SPN aufnehmen.

Weitere Informationen finden Sie unter Setspn Übersicht.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-MaxConnectionRetryCount

Gibt an, wie oft PowerShell versucht, eine Verbindung mit einem Zielcomputer herzustellen, wenn der aktuelle Versuch aufgrund von Netzwerkproblemen fehlschlägt. Der Standardwert ist 5.

Dieser Parameter wurde für PowerShell, Version 5.0, hinzugefügt.

Parametereigenschaften

Parametersätze

-MaximumReceivedDataSizePerCommand

Gibt die maximale Anzahl von Bytes an, die der lokale Computer von dem Remotecomputer in einem einzigen Befehl empfangen kann. Geben Sie einen Wert in Byte ein. Standardmäßig ist kein Grenzwert für die Datengröße vorhanden.

Diese Option wurde entwickelt, um die Ressourcen auf dem Clientcomputer zu schützen.

Parametereigenschaften

Parametersätze

-MaximumReceivedObjectSize

Gibt die maximale Größe eines Objekts an, das der lokale Computer vom Remotecomputer empfangen kann. Diese Option wurde entwickelt, um die Ressourcen auf dem Clientcomputer zu schützen. Geben Sie einen Wert in Byte ein.

Wenn Sie diesen Parameter auslassen, gibt es in Windows PowerShell 2.0 keine Größenbeschränkung für Objekte. Wenn Sie diesen Parameter ab Windows PowerShell 3.0 weglassen, beträgt der Standardwert 200 MB.

Parametereigenschaften

Parametersätze

-MaximumRedirection

Bestimmt, wie oft PowerShell eine Verbindung zu einem alternativen URI (Uniform Resource Identifier) umleitet, bevor die Verbindung fehlschlägt. Der Standardwert ist 5. Ein Wert von 0 (Null) verhindert die gesamte Umleitung.

Diese Option wird nur in der Sitzung verwendet, wenn der AllowRedirection Parameter im Befehl verwendet wird, der die Sitzung erstellt.

Parametereigenschaften

Parametersätze

-NoCompression

Deaktiviert die Paketkomprimierung in der Sitzung. Die Komprimierung verwendet mehr Prozessorzyklen, macht jedoch die Übertragung schneller.

Parametereigenschaften

Parametersätze

-NoEncryption

Deaktiviert die Datenverschlüsselung.

Parametereigenschaften

Parametersätze

-NoMachineProfile

Verhindert das Laden des Windows-Benutzerprofils des Benutzers. Daher kann die Sitzung schneller erstellt werden, aber benutzerspezifische Registrierungseinstellungen, z. B. Umgebungsvariablen und Zertifikate, sind in der Sitzung nicht verfügbar.

Parametereigenschaften

Parametersätze

-OpenTimeout

Bestimmt, wie lange der Clientcomputer wartet, bis die Sitzungsverbindung hergestellt wird. Wenn das Intervall abläuft, schlägt der Befehl zum Herstellen der Verbindung fehl. Geben Sie einen Wert in Millisekunden ein.

Der Standardwert ist 180000 (3 Minuten). Ein Wert von 0 (Null) bedeutet, dass es keine Zeitüberschreitung gibt. Der Befehl wird auf unbestimmte Zeit fortgesetzt.

Parametereigenschaften

Parametersätze

-OperationTimeout

Bestimmt die maximale Zeit, die ein Vorgang in der Sitzung ausgeführt werden kann. Wenn das Intervall abläuft, schlägt der Vorgang fehl. Geben Sie einen Wert in Millisekunden ein.

Der Standardwert ist 180000 (3 Minuten). Ein Wert von 0 (Null) bedeutet, dass es keine Zeitüberschreitung gibt. Der Vorgang wird auf unbestimmte Zeit fortgesetzt.

Parametereigenschaften

Parametersätze

-OutputBufferingMode

Bestimmt, wie die Befehlsausgabe in getrennten Sitzungen verwaltet wird, wenn sich der Ausgabepuffer füllt.

Wenn der Ausgabepuffermodus in der Sitzung oder in der Sitzungskonfiguration nicht festgelegt ist, lautet der Standardwert Block. Benutzer können den Modus für die Ausgabepufferung auch beim Trennen der Sitzung ändern.

Wenn Sie diesen Parameter weglassen, ist der Wert von OutputBufferingMode des Sitzungsoptionsobjekts None. Der Wert Block orDrop überschreibt die in der Sitzungskonfiguration festgelegte Transportoption für den Ausgabepuffermodus. Die zulässigen Werte für diesen Parameter sind:

• Blockieren. Wenn der Ausgabepuffer voll ist, wird die Ausführung angehalten, bis der Puffer gelöscht ist.
• Tropfen. Wenn der Ausgabepuffer voll ist, wird die Ausführung fortgesetzt. Beim Speichern einer neuen Ausgabe wird die älteste Ausgabe verworfen.
• Keiner. Es wird kein Ausgabepuffermodus angegeben.

Weitere Informationen zur Transportoption für den Ausgabepuffermodus finden Sie unter New-PSTransportOption.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-ProxyAccessType

Bestimmt, welcher Mechanismus zum Auflösen des Hostnamens verwendet wird. Die zulässigen Werte für diesen Parameter sind:

• IEConfig
• WinHttpConfig
• AutoDetect
• NoProxyServer
• Nichts

Der Standardwert ist None.

Informationen zu den Werten dieses Parameters finden Sie unter ProxyAccessType Enumeration.

Parametereigenschaften

Parametersätze

-ProxyAuthentication

Gibt die Authentifizierungsmethode an, die für die Proxyauflösung verwendet wird. Die akzeptablen Werte für diesen Parameter sind: Basic, Digest und Negotiate. Der Standardwert ist Negotiate.

Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enumeration in MSDN.

Parametereigenschaften

Parametersätze

-ProxyCredential

Gibt die Anmeldeinformationen an, die für die Proxyauthentifizierung verwendet werden sollen. Geben Sie eine Variable ein, die ein PSCredential-Objekt oder einen Befehl enthält, der ein PSCredential-Objekt liefert, wie z. B. einen Get-Credential-Befehl. Wenn diese Option nicht festgelegt ist, werden keine Anmeldeinformationen angegeben.

Parametereigenschaften

Parametersätze

-SkipCACheck

Gibt an, dass der Client beim Herstellen einer Verbindung über HTTPS nicht überprüft, ob das Serverzertifikat von einer vertrauenswürdigen Zertifizierungsstelle signiert ist.

Verwenden Sie diese Option nur, wenn der Remotecomputer mithilfe eines anderen Mechanismus als vertrauenswürdig eingestuft wird, z. B. wenn der Remotecomputer Teil eines netzwerks ist, das physisch sicher und isoliert ist oder wenn der Remotecomputer in einer WinRM-Konfiguration als vertrauenswürdiger Host aufgeführt wird.

Parametereigenschaften

Parametersätze

-SkipCNCheck

Gibt an, dass der gemeinsame Zertifikatname (Common Name, CN) des Servers nicht mit dem Hostnamen des Servers übereinstimmen muss. Diese Option wird nur in Remotevorgängen verwendet, die das HTTPS-Protokoll verwenden.

Verwenden Sie diese Option nur für vertrauenswürdige Computer.

Parametereigenschaften

Parametersätze

-SkipRevocationCheck

Überprüft nicht den Sperrstatus des Serverzertifikats.

Parametereigenschaften

Parametersätze

-UICulture

Gibt die Benutzeroberflächenkultur an, die für die Sitzung verwendet werden soll.

Gültige Werte sind:

• Ein Kulturname im <languagecode2>-<country/regioncode2> Format, z. B. ja-JP
• Eine Variable, die ein CultureInfo--Objekt enthält
• Ein Befehl, der ein CultureInfo-Objekt abruft, wie z. B. Get-Culture

Der Standardwert ist $null, und die Benutzeroberflächenkultur, die beim Erstellen der Sitzung im Betriebssystem festgelegt wird, wird in der Sitzung verwendet.

Parametereigenschaften

Parametersätze

-UseUTF16

Gibt an, dass dieses Cmdlet die Anforderung im UTF16-Format anstelle des UTF8-Formats codiert.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

PSSessionOption

Hinweise

Ähnliche Themen

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