New-PSSessionOption
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 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:00Beispiel 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 $psoDer 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:00Verwenden 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 120000Wenn 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 $SkipCNDer 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
Gibt ein PrimitiveDictionary an, das an die Remotesitzung gesendet wird. Befehle und Skripts in der Remotesitzung, einschließlich Startskripts in der Sitzungskonfiguration, finden dieses Wörterbuch in der ApplicationArguments-Eigenschaft der $PSSenderInfo automatischen Variablen. Sie können diesen Parameter verwenden, um Daten an die Remotesitzung zu senden.
Weitere Informationen finden Sie unter about_Hash_Tables, about_Session_Configurations und about_Automatic_Variables.
| Type: | PSPrimitiveDictionary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CancelTimeout
Bestimmt, wie lange PowerShell auf den Abschluss eines Abbruchvorgangs (STRG+C) wartet, bevor er beendet wird. 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.
| Type: | Int32 |
| Aliases: | CancelTimeoutMSec |
| Position: | Named |
| Default value: | 60000 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Culture
Gibt die Kultur an, die für die Sitzung verwendet werden soll. Geben Sie einen Kulturnamen im <languagecode2>-<country/regioncode2> Format (z ja-JP. B. ), eine Variable ein, die ein CultureInfo-Objekt enthält, oder einen Befehl, der ein CultureInfo-Objekt abruft.
Der Standardwert ist $Null, und die Kultur, die im Betriebssystem festgelegt wird, wird in der Sitzung verwendet.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeout
Bestimmt, wie lange die Sitzung geöffnet bleibt, wenn der Remotecomputer keine Kommunikation vom lokalen Computer empfängt. Dazu gehört das Taktsignal. Wenn das Intervall abläuft, wird die Sitzung geschlossen.
Der Wert des Leerlauftimeouts ist von erheblicher Bedeutung, wenn Sie beabsichtigen, eine Verbindung mit einer Sitzung zu trennen und erneut herzustellen. Sie können die Sitzung nur dann wiederherstellen, wenn kein Timeout aufgetreten 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 , -1legt kein Leerlauftimeout fest.
Die Sitzung verwendet ggf. das Leerlauftimeout, das in den Sitzungsoptionen festgelegt ist. Wenn keines festgelegt ist (-1), verwendet die Sitzung den Wert der IdleTimeoutMs-Eigenschaft der Sitzungskonfiguration oder des WSMan-Shell-Timeoutwerts (WSMan:\<ComputerName>\Shell\IdleTimeout), je nachdem, welcher Wert am kürzesten 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 ist 7200000 Millisekunden (2 Stunden). Der MaxIdleTimeoutMs-Wert ist 2147483647 Millisekunden (>24 Tage). Der Standardwert des Leerlauftimeouts der WSMan-Shell (WSMan:\<ComputerName>\Shell\IdleTimeout) ist 7200000 Millisekunden (2 Stunden).
Der Wert des Leerlauftimeouts einer Sitzung kann auch geändert werden, wenn die Verbindung von einer Sitzung getrennt oder erneut mit einer Sitzung verbunden wird. Weitere Informationen finden Sie unter Disconnect-PSSession und Connect-PSSession.
In Windows PowerShell 2.0 lautet 240000 der Standardwert des IdleTimeout-Parameters (4 Minuten).
| Type: | Int32 |
| Aliases: | IdleTimeoutMSec |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludePortInSPN
Enthält die Portnummer im Dienstprinzipalnamen (Service Principal Name, SPN), der für die Kerberos-Authentifizierung verwendet wird, HTTP://<ComputerName>:5985z. B. . Mit dieser Option kann ein Client, der einen nicht standardmäßigen SPN verwendet, von einem Remotecomputer authentifiziert werden, der die Kerberos-Authentifizierung verwendet.
Diese Option wurde für Organisationen entwickelt, in 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 keine Kerberos-Authentifizierung verwenden, da ein SPN erforderlich ist, der für das Computerkonto registriert ist. Um dieses Problem zu beheben, können Administratoren unterschiedliche SPNs erstellen, z. B. mithilfe der Setspn.exeVerwendung, die für unterschiedliche Benutzerkonten registriert sind, und zwischen diesen unterscheiden, indem sie die Portnummer in das SPN einschließen.
Weitere Informationen finden Sie unter Setspn Overview.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Bytes ein. Standardmäßig besteht keine Größenbeschränkung für Daten.
Diese Option dient zum Schutz der Ressourcen auf dem Clientcomputer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumReceivedObjectSize
Gibt die maximale Größe eines Objekts an, das der lokale Computer vom Remotecomputer empfangen kann. Diese Option dient zum Schutz der Ressourcen auf dem Clientcomputer. Geben Sie einen Wert in Bytes ein.
In Windows PowerShell 2.0 besteht, wenn Sie diesen Parameter weglassen, keine Größenbeschränkung für Objekte. Beginnend mit Windows PowerShell 3.0, wenn Sie diesen Parameter weglassen, ist 209715200 der Standardwert Bytes (oder 200MB).
| Type: | Int32 |
| Position: | Named |
| Default value: | 209715200 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 alle Umleitungen.
Diese Option wird nur in der Sitzung verwendet, wenn der AllowRedirection-Parameter im Befehl verwendet wird, der die Sitzung erstellt.
| Type: | Int32 |
| Position: | Named |
| Default value: | 5 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoCompression
Deaktiviert die Paketkomprimierung in der Sitzung. Die Komprimierung verwendet mehr Prozessorzyklen, beschleunigt aber die Übertragung.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoEncryption
Deaktiviert die Datenverschlüsselung.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoMachineProfile
Verhindert das Laden des Windows-Benutzerprofils. Daraufhin wird die Sitzung möglicherweise schneller erstellt, aber benutzerspezifische Registrierungseinstellungen wie Umgebungsvariablen und Zertifikate sind in der Sitzung nicht verfügbar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenTimeout
Bestimmt, wie lange der Clientcomputer auf das Einrichten der Sitzungsverbindung wartet. Wenn das Intervall abläuft, tritt bei dem Befehl zum Herstellen der Verbindung ein Fehler auf. 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.
| Type: | Int32 |
| Aliases: | OpenTimeoutMSec |
| Position: | Named |
| Default value: | 180000 (3 minutes) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperationTimeout
Bestimmt die maximale Zeit , zu der WinRM auf positive Verbindungstests aus einer Liveverbindung wartet, bevor ein Verbindungstimeout initiiert wird. Weitere Informationen zu WinRM finden Sie in der Dokumentation zur Windows-Remoteverwaltung.
OperationTimeout erzwingt keine Zeitbeschränkung für Befehle oder Prozesse, die in einer Remotesitzung ausgeführt werden, und wirkt sich nicht auf andere Remotingprotokolle wie SSH aus.
Der Standardwert ist 180000 (3 Minuten). Ein Wert von 0 (Null) bedeutet kein Timeout.
| Type: | Int32 |
| Aliases: | OperationTimeoutMSec |
| Position: | Named |
| Default value: | 180000 (3 minutes) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputBufferingMode
Bestimmt, wie die Befehlsausgabe in getrennten Sitzungen verwaltet wird, wenn sich der Ausgabepuffer füllt.
Wenn der Ausgabepuffermodus nicht in der Sitzung oder in der Sitzungskonfiguration festgelegt ist, lautet Blockder Standardwert . Benutzer können den Modus für die Ausgabepufferung auch beim Trennen der Sitzung ändern.
Wenn Sie diesen Parameter weglassen, lautet Noneder Wert des OutputBufferingMode des SessionOption -Objekts . Ein Wert oder BlockDrop Außerkraftsetzung der Transportoption für den Ausgabepuffermodus in der Sitzungskonfiguration. Zulässige Werte für diesen Parameter:
Block. Wenn der Ausgabepuffer voll ist, wird die Ausführung unterbrochen, bis der Puffer leer ist.Drop. Wenn der Ausgabepuffer voll ist, wird die Ausführung fortgesetzt. Sobald neue Ausgabedaten gespeichert werden, wird die älteste Ausgabe verworfen.None. Es wurde kein Ausgabepufferungsmodus angegeben.
Weitere Informationen zur Transportoption für den Ausgabepuffermodus finden Sie unter New-PSTransportOption.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Type: | OutputBufferingMode |
| Accepted values: | None, Drop, Block |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyAccessType
Bestimmt, welcher Mechanismus zum Auflösen des Hostnamens verwendet wird. Zulässige Werte für diesen Parameter:
IEConfigWinHttpConfigAutoDetectNoProxyServerNone
Der Standardwert ist None.
Informationen zu den Werten dieses Parameters finden Sie unter ProxyAccessType Enumeration.
| Type: | ProxyAccessType |
| Accepted values: | None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyAuthentication
Gibt die Authentifizierungsmethode an, die für die Proxyauflösung verwendet wird. Zulässige Werte für diesen Parameter:
BasicDigestNegotiate
Der Standardwert ist Negotiate.
Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enumeration.
| Type: | AuthenticationMechanism |
| Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | Negotiate |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 abruft, z. B. einen Get-Credential Befehl. Wenn diese Option nicht festgelegt ist, werden keine Anmeldeinformationen angegeben.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 vertrauenswürdig ist, weil er einen anderen Mechanismus verwendet, z. B. wenn er Teil eines physisch sicheren und isolierten Netzwerks ist oder wenn der Remotecomputer in einer WinRM-Konfiguration als vertrauenswürdiger Host aufgeführt ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipCNCheck
Gibt an, dass der gemeinsame Zertifikatname (CN) des Servers nicht mit dem Hostnamen des Servers übereinstimmen muss. Diese Option wird nur bei Remotevorgängen verwendet, die das HTTPS-Protokoll verwenden.
Verwenden Sie diese Option nur für vertrauenswürdige Computer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipRevocationCheck
Der Sperrstatus des Serverzertifikats wird nicht überprüft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UICulture
Gibt die Kultur der Benutzeroberfläche an, die für die Sitzung verwendet werden soll.
Gültige Werte:
- 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, z. B.
Get-Culture
Der Standardwert ist $null, und die Benutzeroberflächenkultur, die beim Erstellen der Sitzung im Betriebssystem festgelegt wird.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUTF16
Gibt an, dass dieses Cmdlet die Anforderung im UTF16-Format anstelle des UTF8-Formats codiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Ausgaben
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für