共用方式為


New-WSManSessionOption

建立會話選項哈希表,以作為 WS-Management Cmdlet 的輸入參數。

語法

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

Description

此 Cmdlet 僅適用於 Windows 平臺。

Cmdlet New-WSManSessionOption 會建立可傳遞至 WSMan Cmdlet 的 WSMan 會話選項哈希表:

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

範例

範例 1:建立使用聯機選項的連線

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

此範例會使用 所 New-WSManSessionOption定義的連接選項,建立與遠端 server01 計算機的連線。

第一個命令會使用 New-WSManSessionOption 將一組連線設定選項儲存在變數中 $a 。 在此情況下,會話選項會設定連線逾時 30 秒(30,000 毫秒)。

第二個命令會 使用 SessionOption 參數,將儲存在 變數中的 $a 認證傳遞至 Connect-WSMan。 然後, Connect-WSMan 使用指定的會話選項連線到遠端 server01 計算機。

Connect-WSMan 通常用於 WSMan 提供者的內容中,以連線到遠端電腦,在此案例中為 server01 計算機。 不過,您可以在變更至 WSMan 提供者之前,先使用 Cmdlet 來建立遠端電腦的連線。 這些聯機會出現在 ComputerName 清單中。

參數

-NoEncryption

表示連線不會針對透過 HTTP 進行遠端作業使用加密。

預設不會啟用未加密的流量。 它必須在本機設定中啟用。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OperationTimeout

指定 WS 管理作業的逾時,以毫秒為單位。

類型:Int32
別名:OperationTimeoutMSec
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ProxyAccessType

指定尋找 Proxy 伺服器的機制。 此參數可接受的值為:

  • ProxyIEConfig - 使用目前使用者的 Internet Explorer Proxy 組態。
  • ProxyWinHttpConfig - WSMan 用戶端會使用針對 WinHTTP 設定的 Proxy 設定,並使用 ProxyCfg.exe 公用程式。
  • ProxyAutoDetect - 強制自動偵測 Proxy 伺服器。
  • ProxyNoProxyServer - 請勿使用 Proxy 伺服器。 在本機解析所有主機名。

預設值為 ProxyIEConfig。

類型:ProxyAccessType
接受的值:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ProxyAuthentication

指定要在 Proxy 使用的驗證方法。 此參數可接受的值為:

  • Basic - 基本是一種配置,用戶名稱和密碼會以純文本傳送至伺服器或 Proxy。
  • Digest - 摘要是一種挑戰回應配置,使用伺服器指定的數據字串來進行挑戰。
  • Negotiate - 交涉是一種挑戰回應配置,會與伺服器或 Proxy 交涉,以判斷要用於驗證的配置。 範例包括 Kerberos 通訊協定與 NTLM。

預設值為 Negotiate。

類型:ProxyAuthentication
接受的值:Negotiate, Basic, Digest
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ProxyCredential

指定有權透過中繼 Web Proxy 取得存取權的用戶帳戶。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SkipCACheck

指定當它透過 HTTPS 連線時,用戶端不會驗證伺服器證書是由受信任的證書頒發機構單位 (CA) 簽署。 只有當遠端電腦受到另一種方法信任時,才使用此選項,例如,如果遠端電腦是實體安全且隔離的網路,或遠端計算機會列為 WS-Management 設定中的受信任主機時。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SkipCNCheck

指定伺服器的憑證一般名稱 (CN) 不需要符合伺服器的主機名。 這隻適用於使用 HTTPS 的遠端作業。 此選項只應該用於信任的計算機。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SkipRevocationCheck

表示連線不會驗證伺服器證書上的撤銷狀態。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SPNPort

指定要附加至遠端伺服器之連線服務主體名稱 (SPN) 的埠號碼。 當驗證機制為 Kerberos 或 Negotiate 時,會使用 SPN。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseUTF16

表示聯機會以 UTF16 格式編碼要求,而不是 UTF8 格式。 預設值為UTF8編碼。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸出

SessionOption

此 Cmdlet 會將建立的 WSMan 工作階段選項當做 SessionOption 物件傳回。