Get-Runspace

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém espaços de execução ativos em um processo de host do PowerShell.

Syntax

Get-Runspace
   [[-Name] <String[]>]
   [<CommonParameters>]
Get-Runspace
   [-Id] <Int32[]>
   [<CommonParameters>]
Get-Runspace
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Description

O Get-Runspace cmdlet obtém espaços de execução ativos em um processo de host do PowerShell.

Exemplos

Exemplo 1: Obter espaços de execução

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

Exemplo 2: Obter espaço de execução por Id

Get-Runspace -Id 2

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

Exemplo 3: Obter espaço de execução por nome

Get-Runspace -Name Runspace1

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

Exemplo 4: Obter espaço de execução por InstanceId

Neste exemplo, identificamos um espaço de execução disponível usando o Name parâmetro e armazenamos o objeto de retorno para a variável $activeRunspace. Isso permite que você use as propriedades do Runspace em execuções subsequentes do Get-Runspace.

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

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

Parâmetros

-Id

Especifica o Id de um espaço de execução

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

-InstanceId

Especifica o GUID do ID da instância de um trabalho em execução.

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

-Name

Especifica o Nome de um espaço de execução

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

Saídas

Runspace

Este cmdlet retorna um Runspace. Você pode canalizar os resultados de um Get-Runspace comando para Debug-Runspace.