Get-CimSession
從目前的工作階段取得 CIM 工作階段物件。
Syntax
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>] Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>] Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>] Get-CimSession
-Name <String[]>
[<CommonParameters>] Description
此 Cmdlet 僅適用於 Windows 平臺。
根據預設，Cmdlet 會取得在目前 PowerShell 工作階段中建立的所有 CIM 作業階段。 您可以使用 的參數 Get-CimSession 來取得特定計算機的會話，也可以依其名稱或其他標識碼來識別會話。 Get-CimSession 不會取得在其他 PowerShell 工作階段中建立或在其他電腦上建立的 CIM 作業階段。
如需 CIM 會話的詳細資訊，請參閱 about_CimSession。
範例
範例 1：從目前的 PowerShell 工作階段取得 CIM 工作階段
此範例會使用 New-CimSession 建立 CIM 會話，然後使用 取得 CIM 會話 Get-CimSession。
New-CimSession -ComputerName Server01,Server02
Get-CimSession
Id : 1
Name : CimSession1
InstanceId : d1413bc3-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol : WSMAN
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN範例 2：取得特定計算機的 CIM 會話
這個範例會取得連線到名為 Server02 之電腦的 CIM 會話。
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN範例 3：取得 CIM 會話的清單，然後格式化清單
本範例會取得目前 PowerShell 工作階段中的所有 CIM 工作階段，並顯示只包含 ComputerName 和 InstanceID 屬性的數據表。
Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710範例 4：取得具有特定名稱的所有 CIM 工作階段
這個範例會取得名稱開頭為 serv 的所有 CIM 會話。
Get-CimSession -ComputerName Serv*
Id : 1
Name : CimSession1
InstanceId : d1413bc-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol : WSMAN
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN範例 5：取得特定的 CIM 會話
這個範例會取得 標識碼為 2 的 CIM 會話。
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN參數
-ComputerName
指定要連線 CIM 工作階段的電腦名稱。 允許使用萬用字元。
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Id
指定要取得之 CIM 會話的標識碼。 對於多個標識符，請使用逗號分隔標識符，或使用範圍運算符 (..) 來指定標識符範圍。 標識碼是整數，可唯一識別目前PowerShell會話內的CIM會話。
如需範圍運算子的詳細資訊，請參閱 about_Operators。
| Type: | UInt32[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InstanceId
指定要取得之 CIM 會話的實例識別碼。
InstanceId 是全域唯一標識符 (GUID) ，可唯一識別 CIM 會話。 InstanceId 是唯一的，即使您在 PowerShell 中執行多個作業階段也是如此。
InstanceId 會儲存在代表 CIM 會話之 物件的 InstanceId 屬性中。
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
取得包含指定易記名稱的一或多個 CIM 工作階段。 允許使用萬用字元。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
輸入
None