Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » New-Event

New-Event - Powershell 3.0 CmdLet

ActiveXperts Network Monitor ships with integrated Powershell scripts to monitor complex network. The scripts run out of the box
Download the ActiveXperts Network Monitor FREE version now »


Short description
Creates a new event.

New-Event [-SourceIdentifier] <String> [[-Sender] <PSObject>] [[-EventArguments] <PSObject[]>] [[-MessageData] <PSObjec
t>] [<CommonParameters>]

The New-Event cmdlet creates a new custom event.

You can use custom events to notify users about state changes in your program and any change that your program can dete
ct, including hardware or system conditions, application status, disk status, network status, or the completion of a ba
ckground job.

Custom events are automatically added to the event queue in your session whenever they are raised; you do not need to s
ubscribe to them. However, if you want to forward an event to the local session or specify an action to respond to the 
event, use the Register-EngineEvent cmdlet to subscribe to the custom event.

When you subscribe to a custom event, the event subscriber is added to your session. If you cancel the event subscripti
on by using the Unregister-Event cmdlet, the event subscriber and custom event are deleted from the session. If you do 
not subscribe to the custom event, to delete the event, you must change the program conditions or close the Windows Pow
erShell session.