Sdílet prostřednictvím

New-WSManSessionOption

  • Reference
Modul:
Microsoft.WSMan.Management

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

Syntaxe

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

Description

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 New-WSManSessionOption.

První příkaz používá New-WSManSessionOption k uložení sady možností nastavení připojení do proměnné $a. V tomto případě možnosti relace nastavily časový limit připojení 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 proměnné $a do Connect-WSMan. Potom se Connect-WSMan připojit ke vzdálenému počítači serveru01 pomocí zadaných možností relace.

Connect-WSMan se obecně používá v kontextu zprostředkovatele WSMan pro připojení ke vzdálenému počítači, v tomto případě počítače server01. Tuto rutinu však můžete použít k navázání připojení ke vzdáleným počítačům před změnou na zprostředkovatele WSMan. Tato připojení se zobrazí v seznamu Název počí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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OperationTimeout

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

Typ:Int32
Aliasy:OperationTimeoutMSec
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyAccessType

Určuje mechanismus, podle kterého se nachází proxy server. Přijatelné hodnoty pro tento parametr jsou:

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

Výchozí hodnota je ProxyIEConfig.

Typ:ProxyAccessType
Přípustné hodnoty:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyAuthentication

Určuje metodu ověřování, která se má použít na proxy serveru. Přijatelné hodnoty pro tento parametr jsou:

  • Basic – Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají na server nebo proxy server ve formátu prostého textu.
  • Digest – Digest je schéma odezvy výzvy, které pro výzvu používá datový řetězec zadaný serverem.
  • Negotiate – Vyjednat je schéma odezvy výzvy, které vyjednává se serverem nebo proxy serverem k určení schématu, které se má použít k ověřování. Příkladem je protokol Kerberos a PROTOKOL NTLM.

Výchozí hodnota je Negotiate.

Typ:ProxyAuthentication
Přípustné hodnoty:Negotiate, Basic, Digest
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyCredential

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipCACheck

Určuje, že když se připojí přes PROTOKOL HTTPS, klient neověří, že certifikát serveru je 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 je vzdálený počítač uveden jako důvěryhodný hostitel v konfiguraci WS-Management.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipCNCheck

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipRevocationCheck

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SPNPort

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UseUTF16

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

SessionOption

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