Megosztás a következőn keresztül:

Wait-Event

Modul:
Microsoft.PowerShell.Utility Module

A futtatás folytatása előtt megvárja, amíg egy adott esemény létrejön.

Syntax

Default (Alapértelmezett) 

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

Description

A Wait-Event parancsmag felfüggeszti egy szkript vagy függvény végrehajtását, amíg egy adott esemény létre nem jön. A végrehajtás folytatódik az esemény észlelésekor. A várakozás megszakításához nyomja le a CTRL+C billentyűkombinációt.

Ez a funkció alternatívát kínál egy esemény lekérdezésére. Lehetővé teszi az eseményre adott válasz két különböző módon történő meghatározását: az esemény-előfizetés Művelet paraméterének használatával, valamint az esemény visszatérésére való várakozással, majd egy művelettel való válaszadással.

Példák

1. példa: Várjon a következő eseményre

PS C:\> Wait-Event

Ez a parancs megvárja a következő eseményt, amely fel van emelve.

2. példa: Várjon egy megadott forrásazonosítóval rendelkező eseményre

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

Ez a parancs megvárja a következő eseményt, amely a ProcessStarted forrásazonosítójával rendelkezik.

3. példa: Várakozás egy időzítő eltelt eseményére

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

Ez a parancs a Wait-Event parancsmaggal várja meg az időzítő eseményeit egy 2000 ezredmásodpercre beállított időzítőn.

4. példa: Várakozás egy eseményre egy megadott időtúllépés után

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

Ez a parancs legfeljebb 90 másodpercet vár a következő eseményre, amely a "ProcessStarted" forrásazonosítóval rendelkezik. Ha a megadott idő lejár, a várakozás véget ér.

Paraméterek

-SourceIdentifier

Megadja azt a forrásazonosítót, amelyre ez a parancsmag az eseményeknél vár. Alapértelmezés szerint Wait-Event minden eseményre vár.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Timeout

Megadja azt a másodpercben megadott maximális időt, amely Várakozási esemény az esemény bekövetkeztére vár. Az alapértelmezett -1 határozatlan ideig várakozik. Az időzítés a Wait-Event parancs elküldésekor kezdődik.

Ha túllépi a megadott időt, a várakozás véget ér, és a parancssor visszatér, még akkor is, ha az eseményt nem emelték ki. Nem jelenik meg hibaüzenet.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:TimeoutSec

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Kimenetek

PSEventArgs

Jegyzetek

  • Az események, az esemény-előfizetések és az eseménysor csak az aktuális munkamenetben léteznek. Ha bezárja az aktuális munkamenetet, a rendszer elveti az eseménysort, és megszakítja az esemény-előfizetést.