New-CimSession
建立 CIM 會話。
Syntax
New-CimSession
[-Authentication <PasswordAuthenticationMechanism>]
[[-Credential] <PSCredential>]
[[-ComputerName] <String[]>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
New-CimSession
[-CertificateThumbprint <String>]
[[-ComputerName] <String[]>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
Description
此 Cmdlet 僅適用於 Windows 平臺。
Cmdlet New-CimSession
會建立 CIM 會話。 CIM 會話是客戶端物件,代表與本機計算機或遠端電腦的連線。 CIM 會話包含連線的相關信息,例如 ComputerName、使用的通訊協定或各種標識碼。
此 Cmdlet 會傳回 CIM 會話物件,可供所有其他 CIM Cmdlet 使用。
範例
範例 1:使用預設選項 Create CIM 會話
此範例會建立具有預設選項的本機 CIM 會話。 如果未指定 ComputerName , New-CimSession
請建立本機電腦的 DCOM 會話。
New-CimSession
範例 2:Create 特定電腦的 CIM 工作階段
此範例會建立 ComputerName 所指定電腦的 CIM 會話。
根據預設, New-CimSession
在指定 ComputerName 時建立 WSMan 工作階段。
New-CimSession -ComputerName Server01
範例 3:Create 多部計算機的 CIM 工作階段
本範例會在逗號分隔清單中,針對 ComputerName 所指定的每部計算機建立 CIM 會話。
New-CimSession -ComputerName Server01,Server02,Server03
範例 4:使用易記名稱 Create CIM 會話
本範例會在逗號分隔清單中,建立 ComputerName 所指定每部計算機的遠端 CIM 會話,並藉由指定 Name 將易記名稱指派給新的工作階段。
New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*
您可以使用 CIM 會話的易記名稱來參考其他 CIM Cmdlet 中的工作階段,例如 Get-CimSession。
範例 5:使用 PSCredential 物件將 CIM 會話 Create 至計算機
這個範例會使用 Credential 所指定的 PSCredential 物件,以及 Authentication 所指定的驗證類型,建立 ComputerName 所指定的電腦 CIM 會話。
New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate
您可以使用 Cmdlet 建立 PSCredential 物件 Get-Credential
。
範例 6:使用特定埠將 CIM 工作階段 Create 電腦
此範例會使用 Port 所指定的 TCP 連接埠,建立 ComputerName 所指定的電腦 CIM 會話。
New-CimSession -ComputerName Server01 -Port 1234
範例 7:使用 DCOM Create CIM 工作階段
此範例會使用 Distributed COM (DCOM) 通訊協定建立 CIM 會話,而不是 WSMan。
$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption
參數
-Authentication
指定用於使用者認證的驗證類型。 此參數可接受的值為:
- Default
- Digest
- 交涉
- 基本資訊
- Kerberos
- NtlmDomain
- CredSsp
您無法使用 NtlmDomain 驗證類型來連線到本機電腦。 CredSSP 驗證僅適用於 Windows Vista、Windows Server 2008 和更新版本的 Windows。
警告
認證安全性服務提供者 (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 |
-CertificateThumbprint
指定有權執行此動作之用戶帳戶的數位公鑰憑證 (X.509) 。 請輸入憑證的憑證指紋。
憑證將用於用戶端憑證式驗證。 這些憑證只能對應至本機使用者帳戶,無法用於網域帳戶。
若要取得憑證指紋,請使用 Get-Item
PowerShell憑證提供者中的 或 Get-ChildItem
Cmdlet。
如需詳細資訊,請參閱 about_Certificate_Provider。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
指定要建立 CIM 工作階段的電腦名稱。 指定單一計算機名稱,或以逗號分隔的多個計算機名稱。
如果未指定 ComputerName ,則會建立本機電腦的 CIM 會話。 您可以使用下列其中一種格式來指定電腦名稱的值:
- 一或多個 NetBIOS 名稱
- 一或多個IP位址
- 一或多個完整功能變數名稱。
如果計算機位於與使用者不同的網域中,您必須指定完整功能變數名稱。
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
指定具有執行此動作權限的使用者帳戶。 如果未指定 Credential ,則會使用目前的用戶帳戶。
使用下列其中一種格式指定 Credential 的值:
- 用戶名稱:“User01”
- 功能變數名稱和使用者名稱:“Domain01\User01”
- 用戶主體名稱:“User@Domain.com”
- PSCredential 物件,例如 Cmdlet 所傳回的物件
Get-Credential
。
當您輸入使用者名稱時,會提示您輸入密碼。
Type: | PSCredential |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定 CIM 工作階段的易記名稱。
使用其他 Cmdlet 時,您可以使用名稱來參考 CIM 會話,例如 Get-CimSession Cmdlet。 該名稱對電腦或目前工作階段而言不需要是唯一的。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Cmdlet 等候伺服器回應的持續時間。
根據預設,此參數的值是0,這表示 Cmdlet 會使用伺服器的預設逾時值。
如果 OperationTimeoutSec 參數設定為小於強固連線重試逾時 3 分鐘的值,則無法復原最後超過 OperationTimeoutSec 參數值的網路失敗,因為伺服器上的作業會在用戶端重新連線之前逾時。
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Port
指定遠端電腦上要供此連線使用的網路連接埠。 若要連線到遠端電腦,遠端電腦必須接聽連線使用的連接埠。 預設連接埠是 5985 (用於 HTTP 的 WinRM 連接埠) 和 5986 (用於 HTTPS 的 WinRM 連接埠)。
使用替代連接埠之前,必須先將遠端電腦上的 WinRM 接聽程式設定為在該連接埠進行接聽。 使用下列命令來設定接聽程式:
winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}
除非必要,否則請勿使用 Port 參數。 命令中的連接埠設定會套用到所有電腦或命令執行所在工作階段。 替代的連接埠設定可能使得命令無法在全部電腦上執行。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
設定新 CIM 工作階段的進階選項。 輸入使用 New-CimSessionOption
Cmdlet 建立的 CimSessionOption 物件名稱。
Type: | CimSessionOptions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipTestConnection
根據預設, New-CimSession
Cmdlet 會基於兩個原因,建立與遠端 WS-Management 端點的連線:若要確認遠端伺服器正在接聽使用 Port 參數指定的埠號碼,以及驗證指定的帳戶認證。 驗證是使用標準 WS-Identity 作業來完成。 如果遠端 WS-Management 端點無法使用 WS-Identify,或減少某些數據傳輸時間,您可以新增 SkipTestConnection 參數。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
None
您無法使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回 CIM 會話物件。
備註
PowerShell 包含下列的 New-CimSession
別名:
- Windows:
ncms
此 Cmdlet 僅適用於 Windows 平臺。