Get-Runspace

Возвращает активные пространства выполнения в хост-процессе PowerShell.

Синтаксис

Get-Runspace
   [[-Name] <String[]>]
   [<CommonParameters>]
Get-Runspace
   [-Id] <Int32[]>
   [<CommonParameters>]
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

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

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

-InstanceId

Указывает ИДЕНТИФИКАТОР экземпляра GUID выполняющегося задания.

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

-Name

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

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

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

Runspace

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