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 会话,然后使用该会话获取 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 会话,并显示仅包含 ComputerNameInstanceID 属性的表。

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 会话的计算机的名称。 允许使用通配符。

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Id

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

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

Type:UInt32[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

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

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

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

Type:Guid[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

输入

None

输出

CimSession