Partager via

Wait-Process

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

Attend que les processus soient arrêtés avant d’accepter davantage d’entrée.

Syntaxe

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

Description

L’applet de commande Wait-Process attend qu’un ou plusieurs processus en cours d’exécution soient arrêtés avant d’accepter l’entrée. Dans la console Windows 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 montre comment arrêter le processus du Bloc-notes, puis attendre que le processus soit arrêté avant de continuer avec la commande suivante.

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

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

La troisième commande utilise de traitement d’attente pour attendre que le processus du Bloc-notes soit arrêté. Il utilise le paramètre id de de wait-process pour identifier le 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 pour wait-Process . La première commande obtient le processus du Bloc-notes et le stocke dans la variable $p.

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

Ces commandes ont les mêmes résultats et peuvent être utilisées de manière interchangeable.

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

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

Cette commande attend 30 secondes pour que les processus Outlook et Winword s’arrêtent. Si les deux processus ne sont pas arrêtés, l’applet de commande affiche une erreur sans fin et l’invite de commandes.

Paramètres

-Id

Spécifie les ID de processus des processus. Pour spécifier plusieurs ID, utilisez des virgules pour séparer les ID. Pour rechercher le PID d’un processus, tapez Get-Process.

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

-InputObject

Spécifie les processus en envoyant des objets de 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 de commande Get-Process.

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

-Name

Spécifie les noms de processus des processus. Pour spécifier plusieurs noms, utilisez des virgules pour séparer les noms. Les caractères génériques ne sont pas pris en charge.

Type:String[]
Alias:ProcessName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 cet intervalle expire, la commande affiche une erreur sans fin qui répertorie les processus qui sont toujours en cours d’exécution et met fin à l’attente. Par défaut, il n’y a pas de délai d’attente.

Type:Int32
Alias:TimeoutSec
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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

  • Cette applet de commande utilise la méthode WaitForExit de la classe System.Diagnostics.Process. Pour plus d’informations sur cette méthode, consultez le Kit de développement logiciel (SDK) Microsoft .NET Framework.