# encoding: ascii
# api: powershell
# title: Register-TemporaryEvent.
# description: From Windows PowerShell Cookbook (O’Reilly) by Lee Holmes
# version: 0.1
# type: script
# author: Lee Holmes
# license: CC0
# x-poshcode-id: 2205
# x-archived: 2016-06-03T06:40:30
# x-published: 2011-09-09T21:42:00
#
#
##############################################################################
##
## Register-TemporaryEvent
##
## From Windows PowerShell Cookbook (O'Reilly)
## by Lee Holmes (http://www.leeholmes.com/guide)
##
##############################################################################
<#
.SYNOPSIS
Registers an event action for an object, and automatically unregisters
itself afterward.
.EXAMPLE
PS >$timer = New-Object Timers.Timer
PS >Register-TemporaryEvent $timer Disposed { [Console]::Beep(100,100) }
PS >$timer.Dispose()
PS >Get-EventSubscriber
PS >Get-Job
#>
param(
## The object that generates the event
$Object,
## The event to subscribe to
$Event,
## The action to invoke when the event arrives
[ScriptBlock] $Action
)
Set-StrictMode -Version Latest
$actionText = $action.ToString()
$actionText += @'
$eventSubscriber | Unregister-Event
$eventSubscriber.Action | Remove-Job
'@
$eventAction = [ScriptBlock]::Create($actionText)
$null = Register-ObjectEvent $object $event -Action $eventAction