CmdID / PowerShell / Cmdlets / New
New-Event
Creates a new event. PowerShell reference
From the PowerShell reference 4 parameters
What it does
Creates a new event. 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 detect, including hardware or system conditions, application status, disk status, network status, or the completion of a background job. Custom events are automatically added to the event queue in your session whenever they are raised; you do not need to subscribe 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 subscription 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 PowerShell session.
New-Event [-SourceIdentifier] <String> [[-Sender] <PSObject>] [[-EventArguments] <PSObject[]>] [[-MessageData] <PSObject>] [<CommonParameters>]
Create a new event in the event queue
PS C:> New-Event -SourceIdentifier Timer -Sender Windows.Timer -MessageData "Test"IdentifyRaise an event in response to another event
PS C:> function Enable-ProcessCreationEvent
{
$Query = New-Object System.Management.WqlEventQuery "__InstanceCreationEvent", (New-Object TimeSpan 0,0,1), "TargetInstance isa 'Win32_Process'"
$ProcessWatcher = New-Object System.Management.ManagementEventWatcher $Query
$Identifier = "WMI.ProcessCreated"
Register-ObjectEvent $ProcessWatcher "EventArrived" -SupportEvent $Identifier -Action
{
[void] (New-Event -SourceId "PowerShell.ProcessCreated" -Sender $args[0] -EventArguments $args[1].SourceEventArgs.NewEvent.TargetInstance)
}
}IdentifyIts page in the reference: New-Event.
Parameters
-EventArgumentsSpecifies an object that contains options for the event.-MessageDataSpecifies additional data associated with the event. The value of this parameter appears in the MessageData property of the event object.-SenderSpecifies the object that raises the event. The default is the PowerShell engine.-SourceIdentifierSpecifies a name for the new event. This parameter is required, and it must be unique in the session.
The value of this parameter appears in the SourceIdentifier property of the events.