Wait-Process

Référence

Module:: Microsoft.PowerShell.Management

Attend l'arrêt des processus avant d'accepter une autre entrée.

Syntax

Wait-Process
    [-Name] <String[]>
    [[-Timeout] <Int32>]
    [<CommonParameters>]

Wait-Process
    [-Id] <Int32[]>
    [[-Timeout] <Int32>]
    [<CommonParameters>]

Wait-Process
    [[-Timeout] <Int32>]
    -InputObject <Process[]>
    [<CommonParameters>]

Description

L’applet Wait-Process de commande attend qu’un ou plusieurs processus en cours d’exécution soient arrêtés avant d’accepter l’entrée. Dans la console PowerShell, cette applet de commande supprime l’invite de commandes jusqu’à ce que les processus soient arrêtés. Vous pouvez spécifier un processus par nom de processus ou ID de processus (PID) ou diriger un objet de processus vers Wait-Process.

Wait-Process fonctionne uniquement sur les processus s’exécutant sur l’ordinateur local.

Exemples

Exemple 1 : Arrêter un processus et attendre

PS C:\> $nid = (Get-Process notepad).id
PS C:\> Stop-Process -Id $nid
PS C:\> Wait-Process -Id $nid

Cet exemple arrête le processus du Bloc-notes, puis attend que le processus soit arrêté avant de continuer avec la commande suivante.

La première commande utilise l’applet Get-Process de commande pour obtenir l’ID du processus du Bloc-notes. Il stocke l’ID dans la $nid variable.

La deuxième commande utilise l’applet Stop-Process de commande pour arrêter le processus avec l’ID stocké dans $nid.

La troisième commande utilise Wait-Process pour attendre que le processus du Bloc-notes soit arrêté. Il utilise le paramètre ID de l’identification Wait-Process du processus.

Exemple 2 : Spécification d’un processus

PS C:\> $p = Get-Process notepad
PS C:\> Wait-Process -Id $p.id
PS C:\> Wait-Process -Name "notepad"
PS C:\> Wait-Process -InputObject $p

Ces commandes montrent trois méthodes différentes de spécification d’un processus à Wait-Process. La première commande obtient le processus du Bloc-notes et la stocke dans la $p variable.

La deuxième commande utilise le paramètre ID , la troisième commande utilise le paramètre Name et la quatrième commande utilise le paramètre InputObject .

Ces commandes produisent les mêmes résultats et peuvent être utilisées indifféremment.

Exemple 3 : Attendre les processus pendant une heure spécifiée

PS C:\> Wait-Process -Name outlook, winword -Timeout 30

Cette commande attend l’arrêt des processus Outlook et Winword pendant 30 secondes. Si les deux processus ne se sont pas arrêtés, l’applet de commande affiche une erreur sans fin d’exécution et l’invite de commandes.

Paramètres

-Id

Spécifie les identificateurs des processus. Lorsque vous spécifiez plusieurs identificateurs, séparez-les à l'aide de virgules. Pour rechercher le PID d’un processus, tapez Get-Process.

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

-InputObject

Spécifie les processus en envoyant des objets processus. Entrez une variable qui contient les objets de processus, ou tapez une commande ou une expression qui obtient les objets de processus, tels que l’applet Get-Process de commande.

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

-Name

Spécifie les noms des processus. Pour spécifier plusieurs noms, séparez-les à l’aide de virgules. Les caractères génériques ne sont pas pris en charge.

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

-Timeout

Spécifie la durée maximale, en secondes, que cette applet de commande attend que les processus spécifiés s’arrêtent. Lorsque ce délai expire, la commande affiche une erreur sans fin d’exécution qui répertorie les processus dont l’exécution se poursuit et elle met un terme à l’attente. Par défaut, il n’y a pas de délai d’expiration.

Type:	Int32
Aliases:	TimeoutSec
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

Process

Vous pouvez diriger un objet de processus vers cette applet de commande.

Sorties

None

Cette applet de commande ne génère aucune sortie.

Notes

L’applet de commande est prise en charge uniquement sur les plateformes Windows.

Cette applet de commande utilise la méthode WaitForExit de la classe System.Diagnostics.Process .