New-CimSessionOption

模組:

CimCmdlets

指定 New-CimSession Cmdlet 的進階選項。

語法

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

New-CimSessionOption Cmdlet 會建立 CIM 工作階段選項物件的實例。 您可以使用 CIM 工作階段選項對象作為 New-CimSession Cmdlet 的輸入，以指定 CIM 工作階段的選項。

此 Cmdlet 有兩個參數集，一個用於 WsMan 選項，另一個用於分散式元件物件模型 （DCOM） 選項。 根據您使用的參數而定，Cmdlet 會傳回 DCOM 會話選項的實例，或傳回 WsMan 會話選項。

範例

範例 1：建立 DCOM 的 CIM 工作階段選項物件

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

這組命令會建立 DCOM 通訊協定的 CIM 工作階段選項物件，並將它儲存在名為 $so的變數中。 變數的內容接著會傳遞至 New-CimSession Cmdlet。 New-CimSession 接著會使用 變數中定義的選項，使用名為 Server01 的遠端伺服器建立新的 CIM 會話。

範例 2：建立 WsMan 的 CIM 會話選項物件

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

此命令會建立 WsMan 通訊協定的 CIM 工作階段選項物件。 物件包含 ProxyAuthentication 參數所指定 Kerberos 驗證模式的組態、ProxyCredential 參數所指定的認證，並指定命令是略過 CA 檢查、略過 CN 檢查，以及使用 SSL。

範例 3：建立具有指定文化特性的 CIM 工作階段選項物件

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

此命令會指定用於 CIM 會話的文化特性。 根據預設，執行作業時會使用用戶端的文化特性。 不過，您可以使用 Culture 參數覆寫預設文化特性。

參數

-Culture

指定要用於 CIM 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：

以 <languagecode2>-<country/regioncode2> 格式輸入文化特性名稱，例如 “EN-US”。

包含 CultureInfo 物件的變數。

取得 CultureInfo 物件的命令，例如 Get-Culture

類型:	CultureInfo
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EncodePortInServicePrincipalName

指出 Kerberos 連線正在連線到服務主體名稱 （SPN） 包含服務埠號碼的服務。 這種類型的連線並不常見。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Encoding

指定 WsMan 通訊協定所使用的編碼方式。

此參數可接受的值為：Default、Utf8 或 Utf16。

類型:	PacketEncoding
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-HttpPrefix

指定電腦名稱和埠號碼之後的 HTTP URL 部分。 變更這不是常見的。

根據預設，此參數的值是 /wsman。

類型:	Uri
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Impersonation

使用模擬建立 Windows Management Instrumentation （WMI） 的 DCOM 會話。

此參數的有效值為：

• 預設值：DCOM 可以使用其一般安全涉演算法來選擇模擬層級。
• 無：客戶端對伺服器是匿名的。 伺服器進程可以模擬用戶端，但模擬令牌不包含任何資訊且無法使用。
• 識別：允許對象查詢呼叫端的認證。
• 模擬：允許物件使用呼叫端的認證。
• 委派：允許物件允許其他物件使用呼叫端的認證。

如果未指定 Impersonation，New-CimSession Cmdlet 會使用 3：Impersonate 的值

類型:	ImpersonationType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MaxEnvelopeSizeKB

指定任一方向的 WsMan XML 訊息大小限制。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-NoEncryption

指定數據加密已關閉。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PacketIntegrity

指定建立至 WMI 的 DCOM 會話使用元件物件模型 （COM） PacketIntegrity 功能。 為了增強安全性，根據預設，使用DCOM建立的所有 CIM 工作階段都會將PacketIntegrity 參數設定為 True。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PacketPrivacy

使用 COM PacketPrivacy 建立 WMI 的 DCOM 會話。 為了增強安全性，根據預設，使用DCOM建立的所有 CIM 工作階段都會將PacketPrivacy 參數設定為 true。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Protocol

指定要使用的通訊協定。

此參數可接受的值為：DCOM 或 WinRM。

類型:	ProtocolType
接受的值:	Dcom, Default, Wsman
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ProxyAuthentication

指定要用於 Proxy 解析的驗證方法。

此參數可接受的值為：Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。

類型:	PasswordAuthenticationMechanism
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ProxyCertificateThumbprint

指定使用者帳戶進行 Proxy 驗證的 （x.509） 數位公鑰憑證。 輸入憑證的憑證指紋。

憑證用於客戶端憑證型驗證。 它們只能對應至本機用戶帳戶，而且無法與網域帳戶搭配使用。

若要取得憑證指紋，請使用PowerShell憑證：磁碟驅動器中的 Get-Item 或 Get-ChildItem Cmdlet。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ProxyCredential

指定要用於 Proxy 驗證的認證。 輸入下列其中一項：

• 包含 PSCredential 物件的變數。
• 取得 PSCredential 物件的命令，例如 Get-Credential

如果未設定此選項，則您無法指定任何認證。

類型:	PSCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProxyType

指定要使用的主機名解析機制。

此參數可接受的值為：None、WinHttp、Auto 或 InternetExplorer。

根據預設，此參數的值是 InternetExplorer。

類型:	ProxyType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SkipCACheck

指出透過 HTTPS 連線時，用戶端不會驗證伺服器證書是由受信任的證書頒發機構單位 （CA） 簽署。

只有當遠端電腦使用另一種機制信任時，才使用此參數，例如當遠端電腦是實體安全與隔離的網路一部分，或當遠端電腦列在 WinRM 組態中為受信任的主機時。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SkipCNCheck

表示伺服器的憑證一般名稱 （CN） 不需要符合伺服器的主機名。

僅適用於使用 HTTPS 通訊協定的遠端作業。

注意：只對受信任的計算機使用此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SkipRevocationCheck

表示略過伺服器證書的撤銷檢查。

注意：只對受信任的計算機使用此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UICulture

指定要用於 CIM 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：

• 以 <languagecode2>-<country/regioncode2> 格式輸入文化特性名稱，例如 “EN-US”。
• 包含 CultureInfo 物件的變數。
• 取得 CultureInfo 物件的命令，例如 Get-Culture。

類型:	CultureInfo
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UseSsl

表示應該使用 SSL 來建立遠端電腦的連線。 根據預設，不會使用 SSL。

WsMan 會加密透過網路傳輸的所有內容。 此參數可讓您指定 HTTPS 的額外保護，而不是 HTTP。 如果連線所使用的埠無法使用 SSL，而且您指定此參數，則命令會失敗。

只有在未指定 PacketPrivacy 參數時，才建議您使用此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

輸入

None

此 Cmdlet 不接受任何輸入物件。

輸出

CIMSessionOption

此 Cmdlet 會傳回包含 CIM 工作階段選項資訊的物件。

相關連結

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession