共用方式為

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

此 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
類型:CultureInfo
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-EncodePortInServicePrincipalName

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

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

-Encoding

指定 WsMan 通訊協定所使用的編碼方式。 此參數可接受的值為： Default、 Utf8 或 Utf16。

類型:PacketEncoding
接受的值:Default, Utf8, Utf16
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，Cmdlet 會New-CimSession使用 Impersonate 的值。

類型:ImpersonationType
接受的值:Default, None, Identify, Impersonate, Delegate
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、 Default 或 Wsman。

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

-ProxyAuthentication

指定要用於 Proxy 解析的驗證方法。 此參數可接受的值為：Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。

類型:PasswordAuthenticationMechanism
接受的值:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ProxyCertificateThumbprint

指定使用者帳戶進行 Proxy 驗證的 （x.509） 數位公鑰憑證。 輸入憑證的憑證指紋。 憑證將用於用戶端憑證式驗證。 它們只能對應至本機用戶帳戶，而且無法與網域帳戶搭配使用。

若要取得憑證指紋，請使用 Get-Item PowerShell憑證：磁碟驅動器中的或 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
接受的值:None, WinHttp, Auto, InternetExplorer
Position:Named
預設值:InternetExplorer
必要: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 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：

  • 格式為 「EN-US」 的文化特性名稱 <languagecode2>-<country/regioncode2> 。
  • 包含 CultureInfo 物件的變數。
  • 取得 CultureInfo 物件的命令，例如 Get-Culture。
類型:CultureInfo
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-UseSsl

表示應該使用 SSL 來建立遠端電腦的連線。 預設不會使用 SSL。 WsMan 會加密透過網路傳輸的所有內容，即使使用 HTTP 也是如此。

此參數可讓您指定 HTTPS 的額外保護，而不是 HTTP。 如果連線所使用的埠無法使用 SSL，而且您指定此參數，則命令會失敗。

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

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

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

CimSessionOptions

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

備註

PowerShell 包含下列的 New-CimSessionOption別名：

  • Windows:
    • ncso

此 Cmdlet 僅適用於 Windows 平臺。