Freigeben über

New-PSSessionOption

  • Referenz
Modul:
Microsoft.PowerShell.Core

Erstellt ein Objekt, das erweiterte Optionen für eine PSSession enthält.

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 cmdlet New-PSSessionOption erstellt ein Objekt mit erweiterten Optionen für eine vom Benutzer verwaltete Sitzung (PSSession). Sie können das Objekt als Wert des SessionOption--Parameters von Cmdlets verwenden, die eine PSSession-erstellen, z. B. New-PSSession, Enter-PSSessionund Invoke-Command.

Ohne Parameter generiert New-PSSessionOption ein Objekt, 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 auch ein SessionOption--Objekt in der $PSSessionOption Einstellungsvariable speichern. Die Werte dieser Variablen legen neue Standardwerte für die Sitzungsoptionen fest. 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. Sie haben jedoch keine Vorrang vor maximalen Werten, 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 Cmdlet New-PSSession zum Erstellen einer Sitzung auf dem Server01-Remotecomputer. 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 Cmdlet Enter-PSSession, 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, der die parameter NoEncryption und NoCompression enthält.

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

Beispiel 4: Ändern eines Sitzungsoptionsobjekts

In diesem Beispiel wird veranschaulicht, dass Sie das SessionOption-objekt ändern können. Alle Eigenschaften weisen Lese-/Schreibwerte auf.

$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 davon für bestimmte Zwecke zu erstellen.

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 Cmdlets New-PSSession, Enter-PSSessionund Invoke-Command erstellt 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 Cmdlet New-PSSessionOption, um ein SessionOption--Objekt zu erstellen, das über die eigenschaft SkipCNCheck verfügt. Der Befehl speichert das resultierende Sitzungsobjekt in der $skipCN Variablen.

Der zweite Befehl verwendet das Cmdlet New-PSSession zum Erstellen einer neuen Sitzung auf einem Remotecomputer. Die $skipCN Prüfvariable wird im Wert des SessionOption-Parameters verwendet.

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

Beispiel 7: Bereitstellen von Argumenten für eine Remotesitzung

In diesem Beispiel wird gezeigt, wie Sie den parameter ApplicationArguments des Cmdlets New-PSSessionOption 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 Hash-Tabelle mit zwei Schlüsseln, Team und Use. Der Befehl speichert die Hashtabelle in der variablen $team. Weitere Informationen zu Hashtabellen finden Sie unter about_Hash_Tables.

Als Nächstes erstellt das New-PSSessionOption-Cmdlet mithilfe des ApplicationArguments- Parameters ein SessionOption-Objekt, das in der $team Variablen gespeichert ist. Wenn New-PSSessionOption das Sitzungsoptionsobjekt erstellt, 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 Cmdlet New-PSSession startet eine Sitzung auf dem Server01-Computer. Er verwendet den parameter SessionOption, um die Optionen in die variable $teamOption einzuschließen.

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

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

Parameter

-ApplicationArguments

Gibt ein PrimitiveDictionary 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.

Typ:PSPrimitiveDictionary
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CancelTimeout

Bestimmt, wie lange PowerShell auf einen Abbruchvorgang wartet (STRG+C) bis zum Beenden. Geben Sie einen Wert in Millisekunden ein.

Der Standardwert ist 60000 (eine Minute). Ein Wert von 0 (Null) bedeutet kein Timeout; der Befehl wird unbegrenzt fortgesetzt.

Typ:Int32
Aliase:CancelTimeoutMSec
Position:Named
Standardwert:60000
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:CultureInfo
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdleTimeout

Bestimmt, wie lange die Sitzung geöffnet bleibt, wenn der Remotecomputer keine Kommunikation vom lokalen Computer empfängt. Dazu gehört das Herzschlagsignal. 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 ist 60000 (1 Minute). Der Höchstwert ist der Wert der MaxIdleTimeoutMs Eigenschaft der Sitzungskonfiguration. Der Standardwert -1 legt kein Leerlauf-Timeout fest.

Die Sitzung nutzt, falls vorhanden, das Leerlauf-Zeitlimit, das in den Sitzungsoptionen festgelegt ist. Wenn kein Wert (-1) festgelegt ist, verwendet die Sitzung den Wert der IdleTimeoutMs-Eigenschaft der Sitzungskonfiguration oder den WSMan-Shell-Timeout-Wert (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 Wert von IdleTimeoutMs in der Standardkonfiguration der Microsoft.PowerShell-Sitzung beträgt 7200000 Millisekunden (2 Stunden). Der MaxIdleTimeoutMs Wert ist 2147483647 Millisekunden (>24 Tage). Der Standardwert für den Leerlauf-Timeout 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).

Typ:Int32
Aliase:IdleTimeoutMSec
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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 für unterschiedliche Benutzerkonten registriert sind und zwischen diesen unterscheiden können, indem sie die Portnummer in das SPN einschließen.

Weitere Informationen finden Sie unter Setspn Übersicht.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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. Ab Windows PowerShell 3.0, wenn Sie diesen Parameter weglassen, ist der Standardwert 209715200 Bytes (oder 200MB).

Typ:Int32
Position:Named
Standardwert:209715200
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:Int32
Position:Named
Standardwert:5
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoCompression

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

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoEncryption

Deaktiviert die Datenverschlüsselung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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 kein Timeout; der Befehl wird unbegrenzt fortgesetzt.

Typ:Int32
Aliase:OpenTimeoutMSec
Position:Named
Standardwert:180000 (3 minutes)
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperationTimeout

Legt die maximale Zeit fest, die WinRM auf positive Verbindungstests einer Live-Verbindung wartet, bevor ein Time-out der Verbindung eingeleitet wird. Weitere Informationen zu WinRM finden Sie in der Windows Remote Management Dokumentation.

OperationTimeout setzt kein Zeitlimit für Befehle oder Prozesse, die in einer Remotesitzung ausgeführt werden, und hat keine Auswirkungen auf andere Remoting-Protokolle wie SSH.

Der Standardwert ist 180000 (3 Minuten). Ein Wert von 0 (Null) bedeutet kein Timeout.

Typ:Int32
Aliase:OperationTimeoutMSec
Position:Named
Standardwert:180000 (3 minutes)
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OutputBufferingMode

Bestimmt, wie die Befehlsausgabe in getrennten Sitzungen verwaltet wird, wenn der Ausgabepuffer voll wird.

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

Wenn Sie diesen Parameter weglassen, wird der Wert des OutputBufferingMode- des SessionOption -Objekts None. Ein Wert von Block oder Drop setzt die in der Sitzungskonfiguration festgelegte Transportoption für den Ausgabepuffermodus außer Kraft. Die zulässigen Werte für diesen Parameter sind:

  • Block. Wenn der Ausgabepuffer voll ist, wird die Ausführung angehalten, bis der Puffer gelöscht ist.
  • Drop. Wenn der Ausgabepuffer voll ist, wird die Ausführung fortgesetzt. Beim Speichern einer neuen Ausgabe wird die älteste Ausgabe verworfen.
  • None. 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.

Typ:OutputBufferingMode
Zulässige Werte:None, Drop, Block
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProxyAccessType

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

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

Der Standardwert ist None.

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

Typ:ProxyAccessType
Zulässige Werte:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProxyAuthentication

Gibt die Authentifizierungsmethode an, die für die Proxyauflösung verwendet wird. Die zulässigen Werte für diesen Parameter sind:

  • Basic
  • Digest
  • Negotiate

Der Standardwert ist Negotiate.

Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Auflistung.

Typ:AuthenticationMechanism
Zulässige Werte:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Standardwert:Negotiate
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipCNCheck

Gibt an, dass der gemeinsame Zertifikatname (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.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipRevocationCheck

Überprüft nicht den Sperrstatus des Serverzertifikats.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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 $nullund die Benutzeroberflächenkultur, die beim Erstellen der Sitzung im Betriebssystem festgelegt wird.

Typ:CultureInfo
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseUTF16

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

PSSessionOption

Hinweise

Wenn der SessionOption Parameter nicht in einem Befehl verwendet wird, um eine PSSession-zu erstellen, werden die Sitzungsoptionen durch die Eigenschaftswerte der $PSSessionOption Einstellungsvariablen bestimmt, wenn sie festgelegt ist. Weitere Informationen zur $PSSessionOption Variablen finden Sie unter about_Preference_Variables.

Die Eigenschaften eines Sitzungskonfigurationsobjekts variieren je nach den für die Sitzungskonfiguration festgelegten Optionen und den Werten dieser Optionen. Außerdem verfügen Sitzungskonfigurationen, die eine Sitzungskonfigurationsdatei verwenden, über zusätzliche Eigenschaften.