Get-CimSession

Ссылка

Модуль:: CimCmdlets

Возвращает объекты сеанса CIM из текущего сеанса.

Синтаксис

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

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

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

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

Описание

По умолчанию командлет получает все сеансы CIM, созданные в текущем сеансе PowerShell. С помощью параметров Get-CimSession можно получить сеансы, которые предназначены для определенных компьютеров, или определить сеансы по их именам или другим идентификаторам. Get-CimSession не получает сеансы CIM, созданные в других сеансах PowerShell или созданные на других компьютерах.

Дополнительные сведения о сеансах CIM см. в about_CimSession.

Примеры

Пример 1. Получение сеансов CIM из текущего сеанса PowerShell

Этот пример создает сеансы CIM с помощью New-CimSession, а затем получает сеансы 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 на определенный компьютер

В этом примере возвращаются сеансы CIM, подключенные к компьютеру с именем Server02.

Get-CimSession -ComputerName Server02

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

Пример 3. Получение списка сеансов CIM и форматирование списка

Этот пример получает все сеансы CIM в текущем сеансе PowerShell и отображает таблицу, содержащую только свойства 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 с определенными именами

В этом примере возвращаются все сеансы 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

В этом примере возвращается сеанс CIM с идентификатором 2.

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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Id

Указывает идентификатор получаемого сеанса CIM. Для нескольких идентификаторов используйте запятые, чтобы разделить идентификаторы или использовать оператор диапазона (..) для указания диапазона идентификаторов. Идентификатор — это целое число, однозначно определяющее сеанс CIM в текущем сеансе PowerShell.

Дополнительные сведения об операторе диапазона см. в about_Operators.

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

-InstanceId

Указывает идентификаторы экземпляров получаемого сеанса CIM.

InstanceId — это глобальный уникальный идентификатор (GUID), который однозначно идентифицирует сеанс CIM. InstanceId уникален, даже если в PowerShell запущено несколько сеансов.

InstanceId хранится в свойстве InstanceId объекта, представляющего сеанс CIM.

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

-Name

Возвращает один или несколько сеансов CIM, содержащих указанные понятные имена. Можно использовать подстановочные знаки.

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

Входные данные

None

Выходные данные

CimSession