New-CimSessionOption
指定 New-CimSession 指令的進階選項。
語法
ProtocolTypeSet (預設值)
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
WSManParameterSet
New-CimSessionOption
[-NoEncryption]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-EncodePortInServicePrincipalName]
[-Encoding <PacketEncoding>]
[-HttpPrefix <Uri>]
[-MaxEnvelopeSizeKB <UInt32>]
[-ProxyAuthentication <PasswordAuthenticationMechanism>]
[-ProxyCertificateThumbprint <String>]
[-ProxyCredential <PSCredential>]
[-ProxyType <ProxyType>]
[-UseSsl]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
DcomParameterSet
New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
指令 New-CimSessionOption 長會建立一個 CIM 會話選項物件的實例。 你可以用 CIM 會話選項物件作為 cmdlet 的輸入 New-CimSession ，來指定 CIM 會話的選項。
此 cmdlet 有兩組參數，一組用於 WsMan 選項，另一組用於分散式元件物件模型（DCOM）選項。 根據你使用的參數，指令小子會回傳 DCOM 會話選項的實例，或回傳 WsMan 會話選項。
範例
範例 1：建立 DCOM 的 CIM 會話選項物件
此範例為 DCOM 協定建立一個 CIM 會話選項物件，並將其儲存在名為 $so的變數中。 變數的內容接著會傳給 New-CimSession cmdlet。
New-CimSession 然後使用變數中定義的選項，與遠端伺服器建立一個新的 CIM 會話，名為 Server01。
$so = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server01 -SessionOption $so
範例 2：為 WsMan 建立一個 CIM 會話選項物件
此範例為 WsMan 協定建立一個 CIM 會話選項物件。 該物件包含由 ProxyAuthentication 參數指定的 Kerberos 認證模式設定、ProxyCredential 參數所指定的憑證，並指定指令跳過 CA 檢查、跳過 CN 檢查，並使用 SSL。
$option = @{
ProxyAuthentication = 'Kerberos'
ProxyCredential = $cred
SkipCACheck = $true
SkipCNCheck = $true
UseSsl = $true
}
New-CimSessionOption @option
範例 3：建立一個 CIM 會話選項物件，指定文化
New-CimSessionOption -Culture fr-FR -Protocol Wsman
此範例指定用於 CIM 會話的文化。 預設情況下，執行操作時會使用客戶端的文化。 不過，預設文化可以透過 Culture 參數來覆蓋。
參數
-Culture
指定用於 CIM 會話的使用者介面文化。 請使用以下格式之一指定此參數的值：
- 文化名稱格式為
<languagecode2>-<country/regioncode2>「en-US」。 - 一個包含 CultureInfo 物件的變數。
- 一個指令，能接收 CultureInfo 物件，例如 Get-Culture
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-EncodePortInServicePrincipalName
表示 Kerberos 連線正在連接一個服務主體名稱（SPN）包含服務埠號的服務。 這種連線並不常見。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Encoding
指定 WsMan 協定所使用的編碼方式。 此參數的可接受值為： Default、 Utf8 或 Utf16。
參數屬性
| 類型: | PacketEncoding |
| 預設值: | None |
| 接受的值: | Default, Utf8, Utf16 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-HttpPrefix
指定 HTTP URL 中電腦名稱與埠號後的部分。 改變這種情況並不常見。 預設情況下，此參數值為 /wsman。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Impersonation
透過模擬建立一個 DCOM 會話，連接 Windows Management Instrumentation（WMI）。
此參數的有效值為：
- 預設：DCOM 可利用其正常的安全協商演算法選擇模擬層級。
- 無：客戶端對伺服器是匿名的。 伺服器程序可以冒充客戶端，但冒充權杖不包含任何資訊，無法使用。
- 識別：允許物件查詢呼叫者的憑證。
- 模擬：允許物件使用呼叫者的憑證。
- 委派：允許物件允許其他物件使用呼叫者的憑證。
若未指定模擬，指令New-CimSession小程式則使用模擬值。
參數屬性
| 類型: | ImpersonationType |
| 預設值: | None |
| 接受的值: | Default, None, Identify, Impersonate, Delegate |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DcomParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxEnvelopeSizeKB
指定 WsMan XML 訊息在任一方向的大小限制。
參數屬性
| 類型: | UInt32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NoEncryption
指定資料加密已關閉。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PacketIntegrity
規定建立給 WMI 的 DCOM 會話使用元件物件模型（COM） 封包完整性 功能。 預設情況下，所有使用 DCOM 建立的 CIM 會話 參數皆為 True。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DcomParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PacketPrivacy
使用 COM PacketPrivacy 建立一個 DCOM 會話給 WMI。 預設情況下，所有使用 DCOM 建立的 CIM 會話都會將 PacketPrivacy 參數設 為 true。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DcomParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Protocol
指定要使用的通訊協定。 此參數的可接受值為： Dcom、 Default或 Wsman。
參數屬性
| 類型: | ProtocolType |
| 預設值: | None |
| 接受的值: | Dcom, Default, Wsman |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ProtocolTypeSet
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ProxyAuthentication
指定用於代理解析的認證方法。 此參數的可接受值為： Default、 Digest、 Negotiate、 Basic、 Kerberos、 NtlmDomain 或 CredSsp。
參數屬性
| 類型: | PasswordAuthenticationMechanism |
| 預設值: | None |
| 接受的值: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ProxyCertificateThumbprint
指定使用者帳號用於代理驗證的數位公鑰憑證（x.509）。 輸入憑證的指紋。 憑證用於客戶端憑證型驗證。 它們只能對應到本地使用者帳號，且無法支援網域帳號。
若要取得憑證指紋，請使用 Get-Item PowerShell Get-ChildItem 磁碟驅動器中的或 Cert: Cmdlet。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ProxyCredential
指定要用於 Proxy 驗證的認證。 請從以下其中一位進入：
- 一個包含 PSCredential 物件的變數。
- 一個指令能取得 PSCredential 物件，例如
Get-Credential
如果這個選項沒有設定，你就無法指定任何憑證。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ProxyType
指定要使用的主機名稱解析機制。 此參數的可接受值為： 無、 WinHttp、 Auto 或 InternetExplorer。
此參數的預設值為 InternetExplorer。
參數屬性
| 類型: | ProxyType |
| 預設值: | InternetExplorer |
| 接受的值: | None, WinHttp, Auto, InternetExplorer |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SkipCACheck
表示當透過 HTTPS 連線時，客戶端並未驗證伺服器憑證是否由受信任的認證機構（CA）簽署。
只有當遠端電腦透過其他機制被信任時，例如遠端電腦屬於物理安全且隔離的網路，或在 WinRM 配置中被列為受信任主機時，才可使用此參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SkipCNCheck
表示伺服器的憑證通用名稱（CN）不必與伺服器主機名稱相符。 此參數僅用於遠端操作，且受信任且使用 HTTPS 協定的電腦。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SkipRevocationCheck
表示跳過伺服器憑證的撤銷檢查。 此參數僅用於受信任的電腦。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UICulture
指定用於 CIM 會話的使用者介面文化。 請使用以下格式之一指定此參數的值：
- 文化名稱格式為
<languagecode2>-<country/regioncode2>「en-US」。 - 一個包含 CultureInfo 物件的變數。
- 一個指令會接收 CultureInfo 物件，例如
Get-Culture。
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UseSsl
表示應使用 SSL 來建立與遠端電腦的連線。 根據預設，不會使用 SSL。 WsMan 會加密所有透過網路傳輸的內容，即使使用 HTTP 也一樣。
這個參數讓你可以指定額外的保護方式是 HTTPS 而非 HTTP。 如果連線所用的埠口沒有 SSL 且你設定了這個參數，那麼指令就會失敗。
建議僅在未指定封 包隱私 參數時使用此參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WSManParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
None
您不能將物件透過管道傳送到此 Cmdlet。
輸出
CimSessionOptions
此 cmdlet 回傳一個包含 CIM 會話選項資訊的物件。
備註
PowerShell 包含下列 New-CimSessionOption的別名：
- 窗戶：
ncso
此 Cmdlet 僅適用於 Windows 平臺。
