获取 CimSession (CimCmdlet)

Get-CimSession

从当前会话中获取 CIM 会话对象。

句法

Get-CimSession
   [[-ComputerName] <String[]>]
   [<CommonParameters>]

Get-CimSession
   [-Id] <UInt32[]>
   [<CommonParameters>]

Get-CimSession
   -InstanceId <Guid[]>
   [<CommonParameters>]

Get-CimSession
   -Name <String[]>
   [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

默认情况下，cmdlet 获取当前 PowerShell 会话中创建的所有 CIM 会话。您可以使用 Get-CimSession 的参数来获取特定计算机的会话，也可以通过会话名称或其他标识符来识别会话。 Get-CimSession 不会获取在其他 PowerShell 会话中创建的或在其他计算机上创建的 CIM 会话。

有关 CIM 会话的详细信息，请参阅 about_CimSession。

示例

示例 1：从当前 PowerShell 会话获取 CIM 会话

此示例使用 New-CimSession 创建 CIM 会话，然后使用 Get-CimSession 获取 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

示例 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 会话

此示例获取 Id 为 2 的 CIM 会话。

Get-CimSession -ID 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

参数

-ComputerName

指定要连接 CIM 会话的计算机的名称。允许使用通配符。

String[]

CN, ServerName

0

None

False

True

True

-Id

指定要获取的 CIM 会话的标识符。对于多个 ID，请使用逗号分隔 ID，或使用范围运算符 (..) 指定 ID 范围。 Id 是一个整数，用于唯一标识当前 PowerShell 会话中的 CIM 会话。

有关范围运算符的更多信息，请参阅 about_Operators。

UInt32[]

0

None

True

True

False

-InstanceId

指定要获取的 CIM 会话的实例 ID。

InstanceId 是唯一标识 CIM 会话的全局唯一标识符 (GUID)。即使您在 PowerShell 中运行多个会话，InstanceId 也是唯一的。

InstanceId 存储在表示 CIM 会话的对象的 InstanceId 属性中。

指导[]

命名

None

True

True

False

-Name

获取一个或多个包含指定友好名称的 CIM 会话。允许使用通配符。

String[]

命名

None

True

True

True

输入

无

您无法将对象通过管道传输到此 cmdlet。

输出

CimSession

此 cmdlet 返回 CIM 会话对象。

笔记

PowerShell 包含以下 Get-CimSession 别名：

• Windows:

  gcms

此 cmdlet 仅在 Windows 平台上可用。