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 New-CimSessionOption 會建立 CIM 會話選項對象的實例。 您可以使用 CIM 工作階段選項物件做為 Cmdlet 的 New-CimSession 輸入，以指定 CIM 工作階段的選項。
此 Cmdlet 有兩個參數集，一個用於 WsMan 選項，另一個用於分散式元件物件模型 (DCOM) 選項。 根據您使用的參數，Cmdlet 會傳回 DCOM 會話選項的實例，或傳回 WsMan 會話選項。
範例
範例 1：Create DCOM 的 CIM 工作階段選項物件
此範例會建立 DCOM 通訊協定的 CIM 工作階段選項物件，並將它儲存在名為 $so的變數中。 變數的內容接著會傳遞至 New-CimSession Cmdlet。
New-CimSession 然後使用變數中定義的選項，使用名為 Server01 的遠端伺服器建立新的 CIM 作業階段。
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so範例 2：Create WsMan 的 CIM 工作階段選項物件
此範例會建立 WsMan 通訊協定的 CIM 工作階段選項物件。 物件包含 ProxyAuthentication 參數所指定 Kerberos 驗證模式的組態、ProxyCredential 參數所指定的認證，並指定命令是要略過 CA 檢查、略過 CN 檢查，以及使用 SSL。
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl範例 3：Create 具有指定文化特性的 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 不接受任何輸入物件。
輸出
CIMSessionOption
這個 Cmdlet 會傳回物件，其中包含 CIM 工作階段選項資訊。