New-WSManSessionOption
Erstellt eine Hashtabelle für Sitzungsoption, die als Eingabeparameter für WS-Management-Cmdlets verwendet werden soll.
Syntax
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das New-WSManSessionOption
Cmdlet erstellt eine WSMan Session-Optionshashtabelle, die an WSMan-Cmdlets übergeben werden kann:
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan
Beispiele
Beispiel 1: Erstellen einer Verbindung, die Verbindungsoptionen verwendet
PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
In diesem Beispiel wird eine Verbindung mit dem Remoteserver01-Computer mithilfe der verbindungsoptionen erstellt, die durch New-WSManSessionOption
definiert werden.
Der erste Befehl verwendet New-WSManSessionOption
, um eine Reihe von Verbindungseinstellungsoptionen in der $a
Variablen zu speichern. In diesem Fall wird durch die Sitzungsoptionen ein Verbindungstimeout von 30 Sekunden (30.000 Millisekunden) festgelegt.
Der zweite Befehl verwendet den Parameter SessionOption , um die Anmeldeinformationen zu übergeben, die in der $a
Variablen Connect-WSMan
gespeichert sind. Stellt dann Connect-WSMan
mithilfe der angegebenen Sitzungsoptionen eine Verbindung mit dem Remoteserver01-Computer hergestellt.
Connect-WSMan
wird in der Regel im Kontext des WSMan-Anbieters verwendet, um eine Verbindung mit einem Remotecomputer herzustellen, in diesem Fall der Server01-Computer. Sie können das Cmdlet jedoch verwenden, um Verbindungen mit Remotecomputern herzustellen, bevor Sie zum WSMan-Anbieter wechseln. Diese Verbindungen werden in der ComputerName-Liste angezeigt.
Parameter
-NoEncryption
Gibt an, dass die Verbindung keine Verschlüsselung für Remotevorgänge über HTTP verwendet.
Der unverschlüsselte Datenverkehr ist standardmäßig nicht aktiviert. Sie muss in der lokalen Konfiguration aktiviert sein.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
Gibt das Timeout in Millisekunden für den WS-Management-Vorgang an.
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAccessType
Gibt den Mechanismus an, mit dem der Proxyserver gesucht wird. Zulässige Werte für diesen Parameter:
ProxyIEConfig
– Verwenden Sie die Internet Explorer-Proxykonfiguration für den aktuellen Benutzer.ProxyWinHttpConfig
– Der WSMan-Client verwendet die Proxyeinstellungen, die für WinHTTP konfiguriert sind, unter Verwendung des ProxyCfg.exe Hilfsprogramms.ProxyAutoDetect
– Die automatische Erkennung eines Proxyservers erzwingen.ProxyNoProxyServer
- Verwenden Sie keinen Proxyserver. Auflösen aller Hostnamen lokal.
Der Standardwert ist ProxyIEConfig.
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAuthentication
Gibt die Authentifizierungsmethode an, die auf dem Proxy verwendet wird. Zulässige Werte für diesen Parameter:
Basic
- Einfach ist ein Schema, bei dem der Benutzername und das Kennwort in Klartext an den Server oder Proxy gesendet werden.Digest
– Digest ist ein Abfrageantwortschema, das eine serverspezifische Datenzeichenfolge für die Abfrage verwendet.Negotiate
- Negotiate ist ein Abfrageantwortschema, das mit dem Server oder Proxy aushandelt, um zu bestimmen, welches Schema für die Authentifizierung verwendet werden soll. Beispiele sind das Kerberos-Protokoll und NTLM.
Der Standardwert ist Negotiate.
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Zugriff über einen Zwischenwebproxy verfügt.
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 von einer anderen Methode als vertrauenswürdig eingestuft wird, z. B. wenn der Remotecomputer Teil eines Netzwerks ist, das physisch sicher und isoliert ist oder der Remotecomputer in der WS-Management-Konfiguration als vertrauenswürdiger Host aufgeführt wird.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCNCheck
Gibt an, dass der gemeinsame Zertifikatname (Common Name, CN) des Servers nicht mit dem Hostnamen des Servers übereinstimmen muss. Diese Option wird nur bei Remotevorgängen über HTTPS eingesetzt und sollte nur für vertrauenswürdige Computer verwendet werden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
Gibt an, dass die Verbindung den Sperrstatus auf dem Serverzertifikat nicht überprüft.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SPNPort
Gibt eine Portnummer an, die an den Verbindungsdienstprinzipalnamen (SPN) des Remoteservers angefügt werden soll. Ein SPN wird verwendet, wenn der Authentifizierungsmechanismus „Kerberos“ oder „Negotiate“ lautet.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
Gibt an, dass die Verbindung die Anforderung im UTF16-Format anstelle des UTF8-Formats codiert. Standardmäßig wird die UTF8-Codierung verwendet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Ausgaben
Dieses Cmdlet gibt die erstellte WSMan-Sitzungsoption als SessionOption-Objekt zurück.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
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 unterFeedback senden und anzeigen für