共用方式為

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 平臺上使用。

New-CimSessionOption Cmdlet 會建立 CIM 工作階段選項物件的實例。 您可以使用 CIM 工作階段選項對象作為 New-CimSession Cmdlet 的輸入，以指定 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 工作階段選項物件。 物件包含 Kerberos 驗證模式的組態， 由 ProxyAuthentication 參數、ProxyCredential 參數指定的認證，並指定命令是略過 CA 檢查、略過 CN 檢查並使用 SSL。

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

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

如果未指定 模擬，New-CimSession Cmdlet 會使用 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） 數位公鑰憑證。 輸入憑證的憑證指紋。 憑證用於客戶端憑證型驗證。 它們只能對應至本機用戶帳戶，而且無法與網域帳戶搭配使用。

若要取得憑證指紋，請使用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
接受的值: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 作業階段的使用者介面文化特性。 使用下列其中一種格式指定此參數的值：

  • <languagecode2>-<country/regioncode2> 格式的文化特性名稱，例如 「EN-US」。。
  • 包含 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別名：

  • 窗戶：
    • ncso

此 Cmdlet 僅適用於 Windows 平臺。