Share via

Wait-Process

  • Referentie
Module:
Microsoft.PowerShell.Management

Wacht tot de processen zijn gestopt voordat meer invoer wordt geaccepteerd.

Syntax

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

Description

Deze cmdlet werkt niet in Linux of macOS.

De Wait-Process cmdlet wacht tot een of meer actieve processen zijn gestopt voordat invoer wordt geaccepteerd. In de PowerShell-console onderdrukt deze cmdlet de opdrachtprompt totdat de processen worden gestopt. U kunt een proces opgeven op basis van procesnaam of proces-id (PID) of een procesobject doorspeken naar Wait-Process.

Wait-Process werkt alleen op processen die op de lokale computer worden uitgevoerd.

Voorbeelden

Voorbeeld 1: Een proces stoppen en wachten

In dit voorbeeld wordt het Kladblok-proces gestopt en wordt gewacht totdat het proces is gestopt voordat het doorgaat met de volgende opdracht.

$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid

De Get-Process cmdlet haalt de proces-id van het Kladblok-proces op en slaat deze op in de $nid variabele. Stop-Process stopt het proces met de id die is opgeslagen in $nid. Wait-Process wacht totdat het Kladblok-proces is gestopt.

Voorbeeld 2: Een proces opgeven

In dit voorbeeld ziet u drie verschillende methoden voor het opgeven van een proces voor Wait-Process. Met de eerste opdracht wordt het Kladblok-proces opgeslagen in de $p variabele. De tweede opdracht maakt gebruik van de parameter Id , de derde opdracht gebruikt de parameter Name en de vierde opdracht gebruikt de parameter InputObject .

$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p

Deze opdrachten hebben dezelfde resultaten en kunnen door elkaar worden gebruikt.

Voorbeeld 3: Een opgegeven tijd wachten op processen

In dit voorbeeld Wait-Process wacht 30 seconden totdat de Outlook - en Winword-processen zijn gestopt. Als beide processen niet worden gestopt, geeft de cmdlet een niet-afsluitfout en de opdrachtprompt weer.

Wait-Process -Name outlook, winword -Timeout 30

Parameters

-Id

Hiermee geeft u de proces-id's van de processen op. Als u meerdere id's wilt opgeven, gebruikt u komma's om de id's te scheiden. Als u de PID van een proces wilt vinden, typt Get-Processu .

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

-InputObject

Hiermee geeft u de processen op door procesobjecten te verzenden. Voer een variabele in die de procesobjecten bevat of typ een opdracht of expressie waarmee de procesobjecten worden opgehaald, zoals de Get-Process cmdlet.

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

-Name

Hiermee geeft u de procesnamen van de processen op. Als u meerdere namen wilt opgeven, gebruikt u komma's om de namen van elkaar te scheiden. Jokertekens worden niet ondersteund.

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

-Timeout

Hiermee geeft u de maximale tijd,in seconden, dat deze cmdlet wacht totdat de opgegeven processen worden gestopt. Wanneer dit interval is verlopen, geeft de opdracht een niet-afsluitfout weer die de processen weergeeft die nog worden uitgevoerd en de wachttijd beëindigt. Standaard is er geen time-out.

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

Invoerwaarden

Process

U kunt een procesobject doorspezen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet genereert geen uitvoer.

Notities

  • Deze cmdlet maakt gebruik van de methode WaitForExit van de klasse System.Diagnostics.Process .

  • In tegenstelling tot Start-Process -Wait, Wait-Process wacht alleen op de geïdentificeerde processen. Start-Process -Wait wacht tot de processtructuur (het proces en alle onderliggende items) is afgesloten voordat het besturingselement wordt geretourneerd.