New-WSManSessionOption

  • Reference
Modul:
Microsoft.WSMan.Management

Vytvoří tabulku hash možností relace, která se použije jako vstupní parametry pro rutiny WS-Management.

Syntax

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina New-WSManSessionOption vytvoří tabulku hash možností relace WSMan, která se dá předat rutinám WSMan:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Příklady

Příklad 1: Vytvoření připojení, které používá možnosti připojení

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

Tento příklad vytvoří připojení ke vzdálenému počítači server01 pomocí možností připojení definovaných nástrojem New-WSManSessionOption.

První příkaz používá New-WSManSessionOption k uložení sady možností nastavení připojení do $a proměnné . V tomto případě možnosti relace nastaví časový limit připojení na 30 sekund (30 000 milisekund).

Druhý příkaz používá parametr SessionOption k předání přihlašovacích údajů uložených v $a proměnné do Connect-WSMan. Pak se Connect-WSMan připojí ke vzdálenému počítači server01 pomocí zadaných možností relace.

Connect-WSMan se obvykle používá v kontextu zprostředkovatele WSMan pro připojení ke vzdálenému počítači, v tomto případě k počítači server01. Můžete však použít rutinu k navázání připojení ke vzdáleným počítačům, než přejdete na zprostředkovatele WSMan. Tato připojení se zobrazí v seznamu Názevpočítače .

Parametry

-NoEncryption

Označuje, že připojení nepoužívá šifrování pro vzdálené operace přes protokol HTTP.

Ve výchozím nastavení není povolený nešifrovaný provoz. Musí být povolená v místní konfiguraci.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Určuje časový limit operace WS-Management v milisekundách.

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

Určuje mechanismus, podle kterého se proxy server nachází. Tento parametr přijímá tyto hodnoty:

  • ProxyIEConfig – Použijte konfiguraci proxy serveru aplikace Internet Explorer pro aktuálního uživatele.
  • ProxyWinHttpConfig – Klient WSMan používá nastavení proxy serveru nakonfigurované pro WinHTTP pomocí nástroje ProxyCfg.exe.
  • ProxyAutoDetect – Vynutí automatickou detekci proxy serveru.
  • ProxyNoProxyServer - Nepoužívejte proxy server. Přeložte všechny názvy hostitelů místně.

Výchozí hodnota je ProxyIEConfig.

Type:Microsoft.WSMan.Management.ProxyAccessType
Accepted values:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

Určuje metodu ověřování, která se má použít na proxy serveru. Tento parametr přijímá tyto hodnoty:

  • Basic – Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají jako prostý text na server nebo proxy server.
  • Digest – Digest je schéma výzvy a odpovědi, které pro výzvu používá datový řetězec zadaný serverem.
  • Negotiate - Negotiate je schéma výzvy a odpovědi, které vyjednává se serverem nebo proxy serverem, aby určilo, které schéma se má použít pro ověřování. Příkladem je protokol Kerberos a NTLM.

Výchozí hodnota je Negotiate.

Type:Microsoft.WSMan.Management.ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Určuje uživatelský účet, který má oprávnění k získání přístupu prostřednictvím zprostředkujícího webového proxy serveru.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

Určuje, že když se klient připojí přes protokol HTTPS, neověří, že je certifikát serveru podepsaný důvěryhodnou certifikační autoritou (CA). Tuto možnost použijte pouze v případě, že je vzdálený počítač důvěryhodný jinou metodou, například pokud je vzdálený počítač součástí sítě, která je fyzicky zabezpečená a izolovaná, nebo pokud je vzdálený počítač uvedený jako důvěryhodný hostitel v konfiguraci WS-Management.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

Určuje, že běžný název certifikátu (CN) serveru se nemusí shodovat s názvem hostitele serveru. Používá se pouze ve vzdálených operacích pomocí protokolu HTTPS. Tato možnost by měla být použita pouze pro důvěryhodné počítače.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Označuje, že připojení neověřuje stav odvolání certifikátu serveru.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SPNPort

Určuje číslo portu, který se připojí k hlavnímu názvu služby (SPN) připojení vzdáleného serveru. Hlavní název služby (SPN) se používá v případě, že mechanismus ověřování je Kerberos nebo Negotiate.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

Označuje, že připojení kóduje požadavek ve formátu UTF16 místo ve formátu UTF8. Výchozí hodnota je kódování UTF8.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Výstupy

Microsoft.WSMan.Management.SessionOption

Tato rutina vrátí vytvořenou možnost relace WSMan jako objekt SessionOption .