Wait-Event

等待,直到在继续运行之前引发特定事件。

语法

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

说明

Wait-Event cmdlet 挂起脚本或函数的执行,直到引发特定事件。 在检测到事件后会继续执行。 若要取消等待,请按 CTRL+C

此功能为事件的轮询提供了一种替代方法。 它还允许以两种不同的方式来确定如何响应事件:

  • 使用事件订阅的 Action 参数
  • 等待事件返回,然后用操作做出响应

示例

示例 1:等待下一个事件

此示例等待引发的下一个事件。

Wait-Event

示例 2:等待具有指定来源标识符的事件

此示例等待所引发的具有来源标识符 ProcessStarted 的下一个事件。

Wait-Event -SourceIdentifier "ProcessStarted"

示例 3:等待计时器已消逝事件

此示例使用 Wait-Event cmdlet 等待一个计时器事件,计时器设置为 2000 毫秒。

$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:等待指定超时后的事件

此示例等待所引发的具有来源标识符 ProcessStarted 的下一个事件,最多等待 90 秒。 如果达到该指定时间,则等待结束。

Wait-Event -SourceIdentifier "ProcessStarted" -Timeout 90

参数

-SourceIdentifier

指定此 cmdlet 等待的事件的来源标识符。 默认情况下,Wait-Event 会等待任何事件。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Timeout

指定 Wait-Event 等待事件发生的最长时间(以秒为单位)。 默认值为 -1,表示无限期地等待。 计时从提交 Wait-Event 命令时开始。

如果超过指定时间,则等待结束,并返回命令提示符,即使尚未引发事件也是如此。 不显示任何错误消息。

类型:Int32
别名:TimeoutSec
Position:Named
默认值:-1
必需:False
接受管道输入:False
接受通配符:False

输入

String

输出

PSEventArgs

备注

事件、事件订阅和事件队列仅存在于当前会话中。 如果关闭当前会话,将丢弃事件队列并取消事件订阅。