Get-Runspace
Obtient des runspaces actifs au sein d’un processus hôte PowerShell.
Syntaxe
NameParameterSet (Par défaut)
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
IdParameterSet
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
InstanceIdParameterSet
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
Propriétés du paramètre
| Type: | Int32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
IdParameterSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InstanceId
Spécifie le GUID d’ID d’instance d’un travail en cours d’exécution.
Propriétés du paramètre
| Type: | Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InstanceIdParameterSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom d’un espace d’exécution
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Sorties
Runspace
Cette applet de commande retourne un Runspace. Vous pouvez diriger les résultats d’une commande Get-Runspace vers Debug-Runspace.