New-CimSessionOption

語法

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

範例

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

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

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

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

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

參數

-Culture

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

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

包含 CultureInfo 物件的變數。

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

參數屬性

參數集

-EncodePortInServicePrincipalName

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

參數屬性

參數集

-Encoding

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

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

參數屬性

參數集

-HttpPrefix

指定電腦名稱和埠號碼之後的 HTTP URL 部分。 更改這一點並不常見。

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

參數屬性

參數集

-Impersonation

使用模擬身份驗證建立與 Windows Management Instrumentation（WMI）的 DCOM 會話。

此參數的有效值為：

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

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

參數屬性

參數集

-MaxEnvelopeSizeKB

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

參數屬性

參數集

-NoEncryption

說明數據加密已關閉。

參數屬性

參數集

-PacketIntegrity

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

參數屬性

參數集

-PacketPrivacy

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

參數屬性

參數集

-Protocol

指定要使用的通訊協定。

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

參數屬性

參數集

-ProxyAuthentication

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

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

參數屬性

參數集

-ProxyCertificateThumbprint

指定用於 Proxy 驗證的使用者帳戶的 (x.509) 數位公鑰憑證。 輸入憑證的指紋。

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

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

參數屬性

參數集

-ProxyCredential

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

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

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

參數屬性

參數集

-ProxyType

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

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

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

參數屬性

參數集

-SkipCACheck

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

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

參數屬性

參數集

-SkipCNCheck

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

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

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

參數屬性

參數集

-SkipRevocationCheck

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

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

參數屬性

參數集

-UICulture

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

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

參數屬性

參數集

-UseSsl

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

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

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

參數屬性

參數集

CommonParameters

輸入

None

輸出

CIMSessionOption

相關連結

• Get-ChildItem（取得子項目）
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession