Public/Invoke-Executable.ps1

function Invoke-Executable
{
    <#
        .DESCRIPTION
            Install or uninstall an EXE
        
        .PARAMETER FilePath
            Specify the path to the EXE file
    
        .PARAMETER Arguments
            Specify additional arguments to pass to the EXE file
    
        .PARAMETER ExitCodes
            Specify non-standard success exit codes (Comma seperated list)
    
        .EXAMPLE
            Install an EXE
                Invoke-Executable -FilePath "$PSScriptRoot\Setup.exe" -Arguments '/S /v"/qn REBOOT=reallysuppress"'
    
            Install an EXE with non-standard exit codes 2 and 8
                Invoke-Executable -FilePath "$PSScriptRoot\Setup.exe" -Arguments '/S' -ExitCodes '2,8'
    
        .NOTES
            Created by: Jon Anderson
            Modified: 2023-07-03
    #>

    [CmdletBinding()]    
    param(
        [parameter(Mandatory = $true)][ValidateScript({
        if(!($_ | Test-Path))
        {
            throw "$_ was not found"
        }
        if(!($_ | Test-Path -PathType Leaf))
        {
            throw "$_ is not a file path"
        }
        if($_ -notmatch "(\.exe)")
        {
            throw "$_ is not an EXE file"
        }
        return $true 
        })]
        [System.IO.FileInfo]$FilePath,
        [parameter(Mandatory = $false)][ValidateNotNullOrEmpty()]
        [String]$Arguments,
        [parameter(Mandatory = $false)][ValidateNotNullOrEmpty()]
        [String]$ExitCodes
    )

    $ArgumentList = New-Object 'System.Collections.Generic.List[string]'
    if($ExitCodes)
    {
        $ExitSplit = $ExitCodes.Split(',')
    }
    if($Arguments)
    {
        $Arguments = $ExecutionContext.InvokeCommand.ExpandString($Arguments)
        $ArgumentList.Add($Arguments)
    }
    $StringFilePath = $FilePath.ToString()
    $StringFilePath = $StringFilePath.insert(0,'"')
    $StringFilePath+='"'
    Write-LogEntry -Value "Running Command: $StringFilePath $ArgumentList" -Severity 1
    if($Arguments)
    {
        $ExitCode = (Start-Process -FilePath $StringFilePath -ArgumentList $ArgumentList -Wait -PassThru).ExitCode
    }
    else
    {
        $ExitCode = (Start-Process -FilePath $StringFilePath -Wait -PassThru).ExitCode
    }
    if(($ExitCode -ne 0) -and ($ExitCode -ne 3010) -and !($ExitSplit -contains $ExitCode))
    {
        Stop-Script -ErrorMessage "The executable terminated with an error: $ExitCode"
    }
    Write-LogEntry -Value "The exit code is $ExitCode" -Severity 1
}