Wait-Event

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

A Wait-Event parancsmag felfüggeszti egy szkript vagy függvény végrehajtását egy adott esemény bekövetkeztéig. 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. Azt is lehetővé teszi, hogy meghatározza az eseményre adott választ két különböző módon:

  • az esemény-előfizetés Művelet paraméterének használatával
  • arra vár, hogy egy esemény visszatérjen, majd egy művelettel válaszoljon

Példák

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

Ez a példa a következő eseményre vár.

Wait-Event

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

Ez a példa a következő eseményre vár, amely a ProcessStarted forrásazonosítójával rendelkezik.

Wait-Event -SourceIdentifier "ProcessStarted"

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

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

$Timer = New-Object Timers.Timer
$objectEventArgs = @{
    InputObject = $Timer
    EventName = 'Elapsed'
    SourceIdentifier = 'Timer.Elapsed'
}
Register-ObjectEvent @objectEventArgs
$Timer.Interval = 2000
$Timer.Autoreset = $False
$Timer.Enabled = $True
Wait-Event Timer.Elapsed

ComputerName     :
RunspaceId       : bb560b14-ff43-48d4-b801-5adc31bbc6fb
EventIdentifier  : 1
Sender           : System.Timers.Timer
SourceEventArgs  : System.Timers.ElapsedEventArgs
SourceArgs       : {System.Timers.Timer, System.Timers.ElapsedEventArgs}
SourceIdentifier : Timer.Elapsed
TimeGenerated    : 4/23/2020 2:30:37 PM
MessageData      :

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

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

Wait-Event -SourceIdentifier "ProcessStarted" -Timeout 90

Paraméterek

-SourceIdentifier

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

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

-Timeout

Megadja azt a másodpercben megadott maximális időt, amely Wait-Event 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.

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

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.