通过

Get-CimSession

模块:
CimCmdlets Module

从当前会话中获取 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>]

说明

此 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[]

默认值:None
支持通配符:True
不显示:False
别名:中国区, 服务器名称

参数集

ComputerNameSet
Position:0
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Id

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

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

参数属性

类型:

UInt32[]

默认值:None
支持通配符:False
不显示:False

参数集

SessionIdSet
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-InstanceId

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

InstanceId 是一个全局唯一标识符（GUID），用于唯一标识 CIM 会话。 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。

输入

None

不能用管道将对象传送到此 cmdlet。

输出

CimSession

此 cmdlet 返回 CIM 会话对象。

备注

PowerShell 包含以下与 Get-CimSession相关的别名：

  • 窗户：
    • gcms

此 cmdlet 仅在 Windows 平台上可用。