Get-Runspace

Módulo:

Microsoft.PowerShell.Utility Module

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

Sintaxis

NameParameterSet (Es el valor predeterminado).

Get-Runspace
    [[-Name] <String[]>]
    [<CommonParameters>]

IdParameterSet

Get-Runspace
    [-Id] <Int32[]>
    [<CommonParameters>]

InstanceIdParameterSet

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.

Propiedades del parámetro

Tipo:	Int32[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

IdParameterSet

Posición:	0
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InstanceId

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

Propiedades del parámetro

Tipo:	Guid[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

InstanceIdParameterSet

Posición:	0
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Name

Especifica el nombre de un espacio de ejecución.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

NameParameterSet

Posición:	0
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

Runspace

Este cmdlet devuelve un Espacio de ejecución. Puede canalizar los resultados de un comando de Get-Runspace para Debug-Runspace.

Vínculos relacionados

• Debug-Runspace