Get-Runspace

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene los espacios de ejecución activos dentro de un proceso de host de PowerShell.

Syntax

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

Description

El Get-Runspace cmdlet obtiene espacios de ejecución activos en un proceso de host de PowerShell.

Ejemplos

Ejemplo 1: Obtener espacios de ejecución

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

Ejemplo 2: Obtención del espacio de ejecución por identificador

Get-Runspace -Id 2

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

Ejemplo 3: Obtener el espacio de ejecución por nombre

Get-Runspace -Name Runspace1

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

Ejemplo 4: Obtención del espacio de ejecución por InstanceId

En este ejemplo, identificamos un espacio de ejecución disponible mediante el Name parámetro y almacenamos el objeto devuelto en la variable $activeRunspace. Esto le permite usar las propiedades del espacio de ejecución en ejecuciones posteriores 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 el identificador de un espacio de ejecución.

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

-InstanceId

Especifica el GUID de identificador de instancia de un trabajo en ejecución.

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

-Name

Especifica el nombre de un espacio de ejecución.

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

Salidas

Runspace

Este cmdlet devuelve un runspace. Puede canalizar los resultados de un Get-Runspace comando a Debug-Runspace.