New-WSManSessionOption

  • 參考
模組:
Microsoft.WSMan.Management

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

Syntax

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

Description

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 進行遠端作業使用加密。

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

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

-OperationTimeout

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

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

-ProxyAccessType

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

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

預設值為 ProxyIEConfig。

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

-ProxyAuthentication

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

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

預設值為 Negotiate。

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

-ProxyCredential

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

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

-SkipCACheck

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

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

-SkipCNCheck

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

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

-SkipRevocationCheck

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

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

-SPNPort

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

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

-UseUTF16

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

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

輸出

SessionOption

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