Поделиться через

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

Описание

Этот командлет доступен только на платформе Windows.

По умолчанию командлет получает все сеансы 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 с именами, начинающимися с Serv.

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. Разрешено использование подстановочных символов.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False
Aliases:Китай, Имя сервера

Наборы параметров

ComputerNameSet
Position:0
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Id

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

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

Свойства параметра

Тип:

UInt32[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SessionIdSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InstanceId

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

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

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

Свойства параметра

Тип:

Guid[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

InstanceIdSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

NameSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

None

Невозможно передать объекты в этот командлет.

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

CimSession

Этот командлет возвращает объект сеанса CIM.

Примечания

PowerShell включает следующие псевдонимы для Get-CimSession:

  • Виндоус:
    • gcms

Этот командлет доступен только на платформах Windows.