Get-Runspace

Referência

Módulo:: Microsoft.PowerShell.Utility

Obtém runspaces 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 runspaces ativos em um processo de host do PowerShell.

Exemplos

Exemplo 1: Obter runspaces

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 runspace 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 de 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

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

-InstanceId

Especifica o GUID da 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 runspace

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

Saídas

Runspace

Você pode direcionar os resultados de um Get-Runspace comando para Debug-Runspace.

Debug-Runspace