Send-Event.ps1

function Send-Event
{
    <#
    .Synopsis
        Sends Events
    .Description
        Sends Events to PowerShell.

        Send-Event is a wrapper for the built-in command New-Event with a few key differences:
        1. It allows MessageData to be piped in
        2. You can send multiple sourceidentifiers
        3. It does not output by default (you must pass -PassThru)
    .Example
        1..4 | Send-Event "Hit It"
    .Link
        New-Event
    .Link
        Watch-Event
    #>
    [OutputType([Nullable],[Management.Automation.PSEventArgs])]
    param(
    # The SourceIdentifier
    [Parameter(Mandatory,Position=0,ValueFromPipelineByPropertyName)]
    [string[]]
    $SourceIdentifier,

    # The message data
    [Parameter(ValueFromPipeline,Position=1,ValueFromPipelineByPropertyName)]
    [PSObject]
    $MessageData,

    # The sender.
    [Parameter(ValueFromPipelineByPropertyName,Position=2)]
    [PSObject]
    $Sender,

    # The event arguments.
    [Parameter(ValueFromPipelineByPropertyName,Position=3)]
    [Alias('SourceEventArgs','EventArgs')]
    [PSObject]
    $EventArguments,

    # If set, will output the created event.
    [Parameter(ValueFromPipelineByPropertyName)]
    [switch]
    $PassThru
    )


    begin {
        # Be we start, get a reference to New-Event
        $newEvent = $ExecutionContext.SessionState.InvokeCommand.GetCommand('New-Event','Cmdlet')
    }
    process {
        #region Map New-Event Parameters
        $myParameters = @{} + $PSBoundParameters
        $newEventParams = @{} + $PSBoundParameters # Copy bound parameters.
        foreach ($k in @($newEventParams.Keys)) {
            if (-not $newEvent.Parameters[$k]) {   # If a parameter isn't for New-Event
                $newEventParams.Remove($k)         # remove it from the copy.
            }
        }
        # If we're piping in MessageData, but the message only contains "Sender" and "Event"
        if ($newEventParams.Sender -and $newEventParams.EventArgs -and
            $newEventParams.MessageData.psobject.properties.Count -eq 2 -and
            $newEventParams.MessageData.Sender -and $newEventParams.MessageData.EventArgs) {
            $newEventParams.Remove('MessageData') # remove the MessageData.
        }
        # Always remove the sourceID parameter (New-Event allows one, Send-Event allows many)
        $newEventParams.Remove('SourceIdentifier')
        #endregion Map New-Event Parameters

        #region Send Each Event
        foreach ($sourceID in $SourceIdentifier) { # Walk over each source identifier
            # and call New-Event.
            $evt = New-Event @newEventParams -SourceIdentifier $sourceID
            if ($PassThru) { # If we want to -PassThru events
                $evt         # output the created event.
            }
        }
        #endregion Send Each Event
    }
}