en-us/Understanding_Event_Sources.help.txt

Understanding Event Sources
---------------------------

Event Sources are scripts that produce events.

They are generally named @NameOfSource.ps1.

Events in PowerShell can be produced in two ways:
* .NET Objects can produce events.
* An event can be sent by PowerShell.

An event source script can return any object with events,
and indicate which events to subscribe to either by addding a
[Diagnostics.Tracing.EventSource(Name='EventName')] attribute
or by adding a noteproperty called "EventName" to the return.

Event sources can be found a few places:

* In the current directory
* In any function whose name starts with @
* In the directory where Watch-Event is defined
* In the module root where Watch-Event is defined
* In an .Eventful [Hashtable] within a module manifest's private data
* In a module that .Tags Eventful

You can see the event sources currently available with:

~~~PowerShell
Get-EventSource
~~~