Get-CimSession
Возвращает объекты сеанса 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 с именами, начинающимися с 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. Можно использовать подстановочные знаки.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Id
Указывает идентификатор получаемого сеанса CIM. Для нескольких идентификаторов используйте запятые для разделения идентификаторов или оператор диапазона (..
) для указания диапазона идентификаторов. Идентификатор — это целое число, которое однозначно идентифицирует сеанс CIM в текущем сеансе PowerShell.
Дополнительные сведения об операторе range см. в разделе 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