Public/Invoke-EmailOnError.ps1

<#
    .SYNOPSIS
    Runs a script block and sends an email if an error occurs.
 
    .DESCRIPTION
    Used to wrap code that needs to report on configuration or authentication errors. I mean we are forced to change passwords. ;-)
 
    .INPUTS
    None. You cannot pipe objects to Invoke-EmailOnError.
 
    .OUTPUTS
    None
 
    .PARAMETER Script
    A script block to execute with a catch to send email if exception is thrown.
 
    .PARAMETER Subject
    The subject of the email.
 
    .EXAMPLE
    PS> Invoke-EmailOnError -Script { Invoke-DoWork } -Subject "Error while executing Invoke-DoWork"
 
    .LINK
    Set-FileEmailConfig
 
    .NOTES
    Assumes email config is initialized using Set-FileEmailConfig
#>

function Invoke-EmailOnError {
    param(
        [ScriptBlock]$Script,
        [String]$Subject
    )

    try {
        $perf = Measure-Command { Invoke-Command -ScriptBlock $Script }
        Write-Information "Duration = $($perf.TotalSeconds) seconds"
    } catch {
        Write-Verbose "ERROR Encountered processsing script block: $($_)"
        Write-Verbose "Attempting to email"
        $firstError = $_
        try {
            Send-Email -Subject $Subject -Message "MESSAGE: $($_.ErrorDetails.Message) STACK: $($_.ScriptStackTrace)"
        } catch {
            Write-Information "SENDING EMAIL FAILED: $($_.Exception.Message)"
        } finally {
            throw $firstError
        }
    }
}