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
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-Id

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

有关范围运算符的详细信息,请参阅 about_Operators

类型:UInt32[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-InstanceId

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

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

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

类型:Guid[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

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

类型:String[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:True

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

CimSession

此 cmdlet 返回 CIM 会话对象。

备注

PowerShell 包含以下 Get-CimSession 别名:

  • Windows:
    • gcms

此 cmdlet 仅在 Windows 平台上可用。