New-WSManSessionOption

Referenz

Modul:: Microsoft.WSMan.Management

Erstellt die 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-Sitzungshashtabelle, 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-WSManSessionOptiondefiniert werden.

Der erste Befehl verwendet New-WSManSessionOption zum Speichern einer Reihe von Verbindungseinstellungsoptionen in der $a Variablen. In diesem Fall wird durch die Sitzungsoptionen ein Verbindungstimeout von 30 Sekunden (30.000 Millisekunden) festgelegt.

Der zweite Befehl verwendet den SessionOption-Parameter , um die Anmeldeinformationen zu übergeben, die in der $a Variablen Connect-WSMangespeichert sind. Stellt dann Connect-WSMan eine Verbindung mit dem Remoteserver01-Computer mithilfe der angegebenen Sitzungsoptionen bereit.

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 Liste "ComputerName " angezeigt.

Parameter

-NoEncryption

Gibt an, dass die Verbindung keine Verschlüsselung für Remotevorgänge über HTTP verwendet.

Standardmäßig ist der unverschlüsselte Datenverkehr 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, und verwendet das ProxyCfg.exe Dienstprogramm.
ProxyAutoDetect - Erzwingen der automatischen Erkennung eines Proxyservers.
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 - Basis ist ein Schema, in dem der Benutzername und das Kennwort im Klartext an den Server oder Proxy gesendet werden.
Digest – Digest ist ein Herausforderungsantwortschema, das eine serverspezifische Datenzeichenfolge für die Herausforderung verwendet.
Negotiate - Negotiate ist ein Herausforderungsantwortschema, 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 eine Berechtigung zum Zugriff über einen zwischengeschalteten Webproxy 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, wenn es eine Verbindung über HTTPS herstellt, nicht überprüft, ob das Serverzertifikat von einer vertrauenswürdigen Zertifizierungsstelle (Zertifizierungsstelle) signiert wird. Verwenden Sie diese Option nur, wenn der Remotecomputer von einer anderen Methode vertrauenswürdig ist, z. B. wenn der Remotecomputer Teil eines Netzwerks ist, das physisch sicher und isoliert ist oder der Remotecomputer als vertrauenswürdiger Host in der WS-Management-Konfiguration aufgeführt ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
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 übereinstimmt. 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

SessionOption