Freigeben über

New-WSManSessionOption

Modul:
Microsoft.WSMan.Management Module

Erstellt eine Sitzungsoptionshashtabelle, die als Eingabeparameter für WS-Management Cmdlets verwendet werden soll.

Syntax

Default (Standardwert) 

New-WSManSessionOption
    [-ProxyAccessType <ProxyAccessType>]
    [-ProxyAuthentication <ProxyAuthentication>]
    [-ProxyCredential <PSCredential>]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-SPNPort <Int32>]
    [-OperationTimeout <Int32>]
    [-NoEncryption]
    [-UseUTF16]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-WSManSessionOption 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, um eine Reihe von Verbindungseinstellungsoptionen in der variablen $a zu speichern. In diesem Fall legen die Sitzungsoptionen eine Verbindungszeit von 30 Sekunden (30.000 Millisekunden) fest.

Der zweite Befehl verwendet den parameter SessionOption, um die Anmeldeinformationen zu übergeben, die in der variablen $a an Connect-WSMangespeichert sind. Anschließend stellt Connect-WSMan mithilfe der angegebenen Sitzungsoptionen eine Verbindung mit dem Remoteserver01-Computer herstellt.

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 jedoch das Cmdlet 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.

Der unverschlüsselte Datenverkehr ist standardmäßig nicht aktiviert. Sie muss in der lokalen Konfiguration aktiviert sein.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OperationTimeout

Gibt das Timeout in Millisekunden für den WS-Management-Vorgang an.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:OperationTimeoutMSec

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyAccessType

Gibt den Mechanismus an, mit dem sich der Proxyserver befindet. Die zulässigen Werte für diesen Parameter sind:

  • 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 – Erzwingen der automatischen Erkennung eines Proxyservers.
  • ProxyNoProxyServer – Verwenden Sie keinen Proxyserver. Auflösen aller Hostnamen lokal.

Der Standardwert ist ProxyIEConfig.

Parametereigenschaften

Typ:ProxyAccessType
Standardwert:None
Zulässige Werte:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyAuthentication

Gibt die Authentifizierungsmethode an, die am Proxy verwendet werden soll. Die zulässigen Werte für diesen Parameter sind:

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

Parametereigenschaften

Typ:ProxyAuthentication
Standardwert:None
Zulässige Werte:Negotiate, Basic, Digest
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Zugriff über einen Zwischenwebproxy verfügt.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 konfiguration WS-Management als vertrauenswürdiger Host aufgeführt wird.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipCNCheck

Gibt an, dass der gemeinsame Zertifikatname (Common Name, CN) des Servers nicht mit dem Hostnamen des Servers übereinstimmen muss. Dies wird nur bei Remotevorgängen mit HTTPS verwendet. Diese Option sollte nur für vertrauenswürdige Computer verwendet werden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipRevocationCheck

Gibt an, dass die Verbindung den Sperrstatus auf dem Serverzertifikat nicht überprüft.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 ist.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UseUTF16

Gibt an, dass die Verbindung die Anforderung im UTF16-Format anstelle des UTF8-Formats codiert. Der Standardwert ist UTF8-Codierung.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

SessionOption

Dieses Cmdlet gibt die erstellte WSMan-Sitzungsoption als SessionOption--Objekt zurück.