Get-CimSession
从当前会话中获取 CIM 会话对象。
语法
ComputerNameSet （默认值）
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
SessionIdSet
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
InstanceIdSet
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
NameSet
Get-CimSession
-Name <String[]>
[<CommonParameters>]
说明
Get-CimSession cmdlet 获取在当前 PowerShell 会话中创建的 CIM 会话对象。
如果未使用任何参数，则 cmdlet 将获取在当前 PowerShell 会话中创建的所有 CIM 会话。
可以使用 Get-CimSession 的参数来获取特定计算机的会话，也可以按会话的名称、ID 或实例 ID 来标识会话。
有关 PowerShell 会话的详细信息，请参阅 about_CimSession。
示例
示例 1：从当前 PowerShell 会话获取 CIM 会话
默认情况下，Get-CimSession 仅获取有关当前 PowerShell 会话中存在的 CIM 会话的信息。
Get-CimSession 不会获取在其他 PowerShell 会话中创建或在其他计算机上创建的 CIM 会话。
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
此命令首先使用 New-CimSession创建 CIM 会话，然后使用 Get-CimSession获取 CIM 会话。
示例 2：获取与特定计算机的 CIM 会话
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
此命令获取连接到名为 Server02 的计算机的 CIM 会话。
示例 3：获取 CIM 会话的列表，然后设置列表的格式
Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710
此命令获取当前 PowerShell 会话中的所有 CIM 会话，然后设置表中仅包含 ComputerName 和 InstanceID 属性的列表的格式。
示例 4：获取具有特定名称的所有 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
此命令获取所有以字符服务器开头的名称的 CIM 会话。
示例 5：获取特定的 CIM 会话
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
此命令获取 ID 为 2 的 CIM 会话。
参数
-ComputerName
指定要连接到 CIM 会话的计算机的名称。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
| 别名: | 中国区, 服务器名称 |
参数集
ComputerNameSet
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Id
指定要获取的 CIM 会话的标识符（ID）。 对于一个或多个 ID，请使用逗号分隔 ID，或使用范围运算符（..）指定一系列 ID。
ID 是一个整数，用于唯一标识当前 PowerShell 会话中的 CIM 会话。 它比 InstanceId 更容易记住和键入，但它仅在当前 PowerShell 会话中是唯一的。
有关范围运算符的详细信息，请参阅 about_Operators。
参数属性
| 类型: | UInt32[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
SessionIdSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InstanceId
指定要获取的 CIM 会话的实例 ID。
InstanceId 是唯一标识 CIM 会话的 GUID。 InstanceId 是唯一的，即使在 PowerShell 中运行多个会话时也是如此。
InstanceId 存储在表示 CIM 会话的对象的 InstanceId 属性中。
参数属性
| 类型: | Guid[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InstanceIdSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
获取一个或多个包含指定易记名称的 CIM 会话。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
NameSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。