New-CimSessionOption
指定 New-CimSession Cmdlet 的進階選項。
Syntax
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] 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>] New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] Description
此 Cmdlet 僅適用於 Windows 平臺。
Cmdlet New-CimSessionOption 會建立 CIM 會話選項對象的實例。 您可以使用 CIM 工作階段選項物件做為 Cmdlet 的輸入 New-CimSession ，以指定 CIM 工作階段的選項。
此 Cmdlet 有兩個參數集，一個用於 WsMan 選項，另一個用於分散式元件物件模型 （DCOM） 選項。 根據您使用的參數而定，Cmdlet 會傳回 DCOM 會話選項的實例，或傳回 WsMan 會話選項。
範例
範例 1：建立 DCOM 的 CIM 工作階段選項物件
此範例會建立 DCOM 通訊協定的 CIM 工作階段選項物件，並將其儲存在名為的 $so變數中。 變數的內容接著會傳遞至 New-CimSession Cmdlet。
New-CimSession 然後使用 變數中定義的選項，建立名為 Server01 之遠端伺服器的新 CIM 工作階段。
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so範例 2：建立 WsMan 的 CIM 會話選項物件
此範例會建立 WsMan 通訊協定的 CIM 工作階段選項物件。 物件包含 ProxyAuthentication 參數所指定 Kerberos 驗證模式的組態、ProxyCredential 參數所指定的認證，並指定命令是略過 CA 檢查、略過 CN 檢查，以及使用 SSL。
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl範例 3：建立具有指定文化特性的 CIM 工作階段選項物件
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman此範例會指定用於 CIM 會話的文化特性。 根據預設，執行作業時會使用用戶端的文化特性。 不過，您可以使用 Culture 參數覆 寫預設文化特性 。
參數
-Culture
指定要用於 CIM 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：
- 格式為 「EN-US」 的文化特性名稱
<languagecode2>-<country/regioncode2>。 - 包含 CultureInfo 物件的變數。
- 取得 CultureInfo 物件的命令，例如 Get-Culture
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
指出 Kerberos 連線正在連線到服務主體名稱 （SPN） 包含服務埠號碼的服務。 這種類型的連線並不常見。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
指定 WsMan 通訊協定所使用的編碼方式。 此參數可接受的值為： Default、 Utf8 或 Utf16。
| Type: | PacketEncoding |
| Accepted values: | Default, Utf8, Utf16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HttpPrefix
指定電腦名稱和埠號碼之後的 HTTP URL 部分。 變更這不是常見的。 根據預設，此參數的值是 /wsman。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Impersonation
使用模擬建立 Windows Management Instrumentation （WMI） 的 DCOM 會話。
此參數的有效值為：
- 預設值：DCOM 可以使用其一般安全性交涉演算法來選擇模擬層級。
- 無：客戶端對伺服器是匿名的。 伺服器進程可以模擬用戶端，但模擬令牌不包含任何資訊且無法使用。
- 識別：允許對象查詢呼叫端的認證。
- 模擬：允許物件使用呼叫端的認證。
- 委派：允許物件允許其他物件使用呼叫端的認證。
如果未指定 Impersonation，Cmdlet 會New-CimSession使用 Impersonate 的值。
| Type: | ImpersonationType |
| Accepted values: | Default, None, Identify, Impersonate, Delegate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
指定任一方向的 WsMan XML 訊息大小限制。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEncryption
指定數據加密已關閉。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketIntegrity
指定建立至 WMI 的 DCOM 會話使用元件物件模型 （COM） PacketIntegrity 功能。 根據預設，使用DCOM建立的所有 CIM 作業階段都會 將PacketIntegrity 參數設定為 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketPrivacy
使用 COM PacketPrivacy 建立 WMI 的 DCOM 會話。 根據預設，使用 DCOM 建立的所有 CIM 工作階段都會 將 PacketPrivacy 參數設定為 true。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
指定要使用的通訊協定。 此參數可接受的值為： DCOM、 Default 或 Wsman。
| Type: | ProtocolType |
| Accepted values: | Dcom, Default, Wsman |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyAuthentication
指定要用於 Proxy 解析的驗證方法。 此參數可接受的值為：Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。
| Type: | PasswordAuthenticationMechanism |
| Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCertificateThumbprint
指定使用者帳戶進行 Proxy 驗證的 （x.509） 數位公鑰憑證。 輸入憑證的憑證指紋。 憑證將用於用戶端憑證式驗證。 它們只能對應至本機用戶帳戶，而且無法與網域帳戶搭配使用。
若要取得憑證指紋，請使用 Get-Item PowerShell憑證：磁碟驅動器中的或 Get-ChildItem Cmdlet。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
指定要用於 Proxy 驗證的認證。 輸入下列其中一項：
- 包含 PSCredential 物件的變數。
- 取得 PSCredential 物件的命令，例如
Get-Credential
如果未設定此選項，則您無法指定任何認證。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyType
指定要使用的主機名解析機制。 此參數可接受的值為：None、WinHttp、Auto 或 InternetExplorer。
此參數的預設值為 InternetExplorer。
| Type: | ProxyType |
| Accepted values: | None, WinHttp, Auto, InternetExplorer |
| Position: | Named |
| Default value: | InternetExplorer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCACheck
指出透過 HTTPS 連線時，用戶端不會驗證伺服器證書是由受信任的證書頒發機構單位 （CA） 簽署。
只有當遠端電腦使用另一種機制信任時，才使用此參數，例如當遠端電腦是實體安全與隔離的網路一部分，或當遠端電腦列在 WinRM 組態中為受信任的主機時。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCNCheck
表示伺服器的憑證一般名稱 （CN） 不需要符合伺服器的主機名。 只有在使用 HTTPS 通訊協定的受信任計算機時，才能使用此參數進行遠端作業。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipRevocationCheck
表示略過伺服器證書的撤銷檢查。 只對受信任的電腦使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UICulture
指定要用於 CIM 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：
- 格式為 「EN-US」 的文化特性名稱
<languagecode2>-<country/regioncode2>。 - 包含 CultureInfo 物件的變數。
- 取得 CultureInfo 物件的命令，例如
Get-Culture。
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseSsl
表示應該使用 SSL 來建立遠端電腦的連線。 預設不會使用 SSL。 WsMan 會加密透過網路傳輸的所有內容，即使使用 HTTP 也是如此。
此參數可讓您指定 HTTPS 的額外保護，而不是 HTTP。 如果連線所使用的埠無法使用 SSL，而且您指定此參數，則命令會失敗。
只有在未指定 PacketPrivacy 參數時，才建議您使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸入
None
您無法使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回包含 CIM 工作階段選項資訊的物件。
備註
PowerShell 包含下列的 New-CimSessionOption別名：
- Windows：
ncso
此 Cmdlet 僅適用於 Windows 平臺。
相關連結
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應