Get-Runspace

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

Obtém runspaces ativos em um processo de host do PowerShell.

Sintaxe

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

Description

O Get-Runspace cmdlet obtém runspaces 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 runspace por Id

Get-Runspace -Id 2

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

Exemplo 3: Obter runspace por nome

Get-Runspace -Name Runspace1

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

Exemplo 4: Obter runspace por InstanceId

Neste exemplo, identificamos um espaço de execução disponível usando o Name parâmetro e armazenamos o objeto de retorno na variável $activeRunspace. Isso permite que você use as propriedades do Runspace em execuções subseqüentes 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 a ID de um runspace

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceId

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

Tipo:Guid[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um runspace

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Runspace

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