New-WSManSessionOption
建立會話選項哈希表，以作為 WS-Management Cmdlet 的輸入參數。
語法
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>] Description
New-WSManSessionOption Cmdlet 會建立可傳遞至 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:\>
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-Management 作業的逾時以毫秒為單位。
| 類型: | 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 上使用的驗證方法。 此參數可接受的值為：
- 基本。 基本是一種配置，用戶名稱和密碼會以純文本傳送至伺服器或 Proxy。
- 消化。 摘要是一種挑戰回應配置，使用伺服器指定的數據字串來進行挑戰。
- 談判。 Negotiate 是一種挑戰回應配置，會與伺服器或 Proxy 交涉，以判斷要用於驗證的配置。 範例包括 Kerberos 通訊協定和 NTLM。
預設值為 Negotiate。
| 類型: | ProxyAuthentication |
| 接受的值: | Negotiate, Basic, Digest |
| Position: | Named |
| 預設值: | Negotiate |
| 必要: | 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