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.

Связанные ссылки

• Debug-Runspace