Compartir a través de

Get-Runspace

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Sintaxis

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

Description

El cmdlet Get-Runspace 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 parámetro Name y almacenamos el objeto devuelto en la variable $activeRunspace. Esto le permite usar las propiedades del runspace 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.

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceId

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

Tipo:Guid[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un espacio de ejecución.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

Runspace

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