Partager via

Get-Runspace

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient des runspaces actifs au sein d’un processus hôte PowerShell.

Syntaxe

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

Description

L’applet de commande Get-Runspace obtient des runspaces actifs dans un processus hôte PowerShell.

Exemples

Exemple 1 : Obtenir des 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

Exemple 2 : Obtenir runspace par ID

Get-Runspace -Id 2

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

Exemple 3 : Obtenir l’espace d’exécution par nom

Get-Runspace -Name Runspace1

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

Exemple 4 : Obtenir runspace par InstanceId

Dans cet exemple, nous identifions un runspace disponible à l’aide du paramètre Name et stockons l’objet de retour dans la variable $activeRunspace. Cela vous permet d’utiliser les propriétés de l'Runspace dans les exécutions suivantes 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

Paramètres

-Id

Spécifie l’ID d’un runspace

Type:Int32[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InstanceId

Spécifie le GUID d’ID d’instance d’un travail en cours d’exécution.

Type:Guid[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un espace d’exécution

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

Runspace

Cette applet de commande retourne un Runspace. Vous pouvez diriger les résultats d’une commande Get-Runspace vers Debug-Runspace.