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

Get-Runspace

Модуль:
Microsoft.PowerShell.Utility Module

Получает активные пространства выполнения в процессе узла PowerShell.

Синтаксис

NameParameterSet (по умолчанию) 

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

IdParameterSet 

Get-Runspace
    [-Id] <Int32[]>
    [<CommonParameters>]

InstanceIdParameterSet 

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

Описание

Командлет Get-Runspace получает активные пространства выполнения в процессе узла PowerShell.

Примеры

Пример 1. Получение пространств выполнения

Get-Runspace

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy
  2 Runspace2       localhost       Local         Opened        Available
  3 Runspace3       localhost       Local         Opened        Available

Пример 2. Получение пространства выполнения по идентификатору

Get-Runspace -Id 2

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  2 Runspace2       localhost       Local         Opened        Available

Пример 3. Получение пространства выполнения по имени

Get-Runspace -Name Runspace1

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy

Пример 4. Получение пространства выполнения по InstanceId

В этом примере мы определяем доступное пространство выполнения с помощью параметра Name и сохраняем возвращаемый объект в переменную $activeRunspace. Это позволяет использовать свойства runspace в последующих запусках Get-Runspace.

$activeRunspace = Get-Runspace -Name Runspace1
Get-Runspace -InstanceId $activeRunspace.InstanceId

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy

Параметры

-Id

Указывает идентификатор пространства выполнения

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

Тип:

Int32[]

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

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

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

-InstanceId

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

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

Тип:

Guid[]

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

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

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

-Name

Указывает имя пространства выполнения

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

Тип:

String[]

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

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

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

CommonParameters

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

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

Runspace

Этот командлет возвращает Runspace. Результаты команды Get-Runspace можно передать в Debug-Runspace.