Dela via

Wait-Event

  • Referens
Modul:
Microsoft.PowerShell.Utility

Väntar tills en viss händelse aktiveras innan den fortsätter att köras.

Syntax

Wait-Event
    [[-SourceIdentifier] <String>]
    [-Timeout <Int32>]
    [<CommonParameters>]

Description

Cmdleten Wait-Event pausar körningen av ett skript eller en funktion tills en viss händelse utlöses. Körningen återupptas när händelsen identifieras. Om du vill avbryta väntan trycker du på CTRL+C.

Den här funktionen är ett alternativ till avsökning för en händelse. Du kan också fastställa svaret på en händelse på två olika sätt: genom att använda parametern Åtgärd för händelseprenumerationen och genom att vänta på att en händelse ska returneras och sedan svara med en åtgärd.

Exempel

Exempel 1: Vänta på nästa händelse

PS C:\> Wait-Event

Det här kommandot väntar på nästa händelse som utlöses.

Exempel 2: Vänta på en händelse med en angiven källidentifierare

PS C:\> Wait-Event -SourceIdentifier "ProcessStarted"

Det här kommandot väntar på nästa händelse som utlöses och som har en källidentifierare för ProcessStarted.

Exempel 3: Vänta tills en tidsinställd händelse har förflutit

PS C:\> $Timer.Interval = 2000
PS C:\> $Timer.Autoreset = $False
PS C:\> $Timer.Enabled = $True; Wait-Event Timer.Elapsed
# After 2 seconds
EventIdentifier  : 12
Sender           : System.Timers.Timer
SourceEventArgs  : System.Timers.ElapsedEventArgs
SourceArgs       : {System.Timers.Timer, System.Timers.ElapsedEventArgs}
SourceIdentifier : Timer.Elapsed
TimeGenerated    : 6/10/2008 3:24:18 PM
MessageData      :
ForwardEvent     : False

Det här kommandot använder cmdleten Wait-Event för att vänta på en timerhändelse på en timer som har angetts för 2 000 millisekunder.

Exempel 4: Vänta på en händelse efter en angiven tidsgräns

PS C:\> Wait-Event -SourceIdentifier "ProcessStarted" -Timeout 90

Det här kommandot väntar upp till 90 sekunder på nästa händelse som aktiveras och som har en källidentifierare för "ProcessStarted". Om den angivna tiden går ut upphör väntetiden.

Parametrar

-SourceIdentifier

Anger den källidentifierare som den här cmdleten väntar på händelser. Som standard väntar Wait-Event på alla händelser.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Timeout

Anger den maximala tid i sekunder som Wait-Event väntar på att händelsen ska inträffa. Standardvärdet -1 väntar på obestämd tid. Tidpunkten startar när du skickar kommandot Wait-Event.

Om den angivna tiden överskrids avslutas väntetiden och kommandotolken returneras, även om händelsen inte har utlösts. Inget felmeddelande visas.

Typ:Int32
Alias:TimeoutSec
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Utdata

PSEventArgs

Kommentarer

  • Händelser, händelseprenumerationer och händelsekön finns bara i den aktuella sessionen. Om du stänger den aktuella sessionen ignoreras händelsekön och händelseprenumerationen avbryts.