Get-VeeamJobReport.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 291d2eb0-7f4e-5949-be78-296193cc84fc
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Monitoring Report Windows Backup Veeam PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-veeamjobreport.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES Veeam.Backup.PowerShell
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Fasst die Backup-Läufe von Veeam Backup & Replication der letzten Stunden in einem HTML-Bericht zusammen.
 
.DESCRIPTION
    Liest alle Sitzungen von Backup-, Backup-Copy- und Replikationsjobs sowie von Agent-Jobs, die der
    Backup-Server verwaltet, aus dem gewählten Zeitraum. Pro Job wird nur der letzte Lauf bewertet:
    Erfolg, Warnung, Fehler oder läuft noch. Jobs, die im Zeitraum gar nicht gelaufen sind, erscheinen
    als "Kein Lauf", damit ein still stehender Job auffällt.
 
    Der Bericht wird als HTML-Datei gespeichert und auf Wunsch per Mail verschickt. Der Betreff beginnt
    mit [OK], [WARNUNG] oder [FEHLER], damit sich Postfachregeln und Ticketsysteme danach richten können.
    Der Exitcode ist 0 (alles erfolgreich), 1 (Warnung) oder 2 (Fehler), passend für die Aufgabenplanung
    oder ein RMM-Tool.
 
.PARAMETER Server
    Backup-Server, mit dem sich das Skript verbindet. Standard: localhost.
 
.PARAMETER Hours
    Zeitraum in Stunden, der ausgewertet wird. Standard: 24.
 
.PARAMETER ReportPath
    Ordner für den HTML-Bericht. Standard: aktueller Ordner.
 
.PARAMETER SmtpServer
    Optional. Mailserver für den Versand des Berichts.
 
.PARAMETER From
    Absender des Berichts.
 
.PARAMETER To
    Empfänger des Berichts.
 
.PARAMETER OnlyProblems
    Mail nur verschicken, wenn mindestens ein Job eine Warnung, einen Fehler oder keinen Lauf hat.
 
.EXAMPLE
    .\Get-VeeamJobReport.ps1
 
    Wertet die letzten 24 Stunden auf dem lokalen Backup-Server aus und speichert den Bericht.
 
.EXAMPLE
    .\Get-VeeamJobReport.ps1 -Hours 48 -SmtpServer mail.contoso.local -From veeam@contoso.local -To it@contoso.local -OnlyProblems
 
    Schickt nur dann eine Mail, wenn in den letzten 48 Stunden etwas nicht in Ordnung war.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Getestet gegen die PowerShell-Befehle von Veeam Backup & Replication 12. Das Modul
    Veeam.Backup.PowerShell wird mit der Konsole installiert. Das Skript arbeitet nur lesend: Es startet,
    stoppt und ändert keine Jobs.
#>

[CmdletBinding()]
param(
    [string] $Server = 'localhost',
    [ValidateRange(1, 720)] [int] $Hours = 24,
    [string] $ReportPath = (Get-Location).Path,
    [string] $SmtpServer,
    [string] $From,
    [string[]] $To,
    [switch] $OnlyProblems
)

Import-Module Veeam.Backup.PowerShell -ErrorAction Stop -WarningAction SilentlyContinue
if (-not (Get-VBRServerSession)) {
    Connect-VBRServer -Server $Server -ErrorAction Stop
}

$now    = Get-Date
$since  = $now.AddHours(-$Hours)
$rows   = [System.Collections.Generic.List[object]]::new()

function Add-Row($name, $type, $session) {
    if ($session) {
        $result = [string]$session.Result
        $state  = [string]$session.State
        if ($state -eq 'Working') { $result = 'Läuft' }
        $end    = if ($session.EndTime -gt $session.CreationTime) { $session.EndTime } else { $null }
        $dauer  = if ($end) { '{0:hh\:mm}' -f ($end - $session.CreationTime) } else { '' }
        $rows.Add([pscustomobject]@{
            Job     = $name
            Typ     = $type
            Ergebnis = switch ($result) { 'Success' { 'Erfolg' } 'Warning' { 'Warnung' } 'Failed' { 'Fehler' } default { $result } }
            Start   = $session.CreationTime.ToString('dd.MM.yyyy HH:mm')
            Dauer   = $dauer
        })
    }
    else {
        $rows.Add([pscustomobject]@{ Job = $name; Typ = $type; Ergebnis = 'Kein Lauf'; Start = ''; Dauer = '' })
    }
}

# Klassische Jobs (Backup, Backup Copy, Replikation)
$sessions = Get-VBRBackupSession | Where-Object { $_.CreationTime -ge $since }
foreach ($job in (Get-VBRJob -WarningAction SilentlyContinue | Where-Object { $_.IsScheduleEnabled })) {
    $last = $sessions | Where-Object { $_.JobId -eq $job.Id } | Sort-Object CreationTime -Descending | Select-Object -First 1
    Add-Row $job.Name ([string]$job.JobType) $last
}

# Agent-Jobs, die der Backup-Server verwaltet
try {
    $agentSessions = Get-VBRComputerBackupJobSession | Where-Object { $_.CreationTime -ge $since }
    foreach ($job in (Get-VBRComputerBackupJob | Where-Object { $_.ScheduleEnabled -ne $false })) {
        $last = $agentSessions | Where-Object { $_.JobId -eq $job.Id } | Sort-Object CreationTime -Descending | Select-Object -First 1
        Add-Row $job.Name 'Agent' $last
    }
}
catch { Write-Verbose "Keine Agent-Jobs gefunden: $_" }

if ($rows.Count -eq 0) {
    Write-Host 'Keine aktiven Jobs gefunden.' -ForegroundColor Yellow
    return
}

$failed  = @($rows | Where-Object { $_.Ergebnis -in 'Fehler', 'Kein Lauf' }).Count
$warning = @($rows | Where-Object { $_.Ergebnis -eq 'Warnung' }).Count
$status  = if ($failed) { 'FEHLER' } elseif ($warning) { 'WARNUNG' } else { 'OK' }
$exit    = if ($failed) { 2 } elseif ($warning) { 1 } else { 0 }

$rows | Sort-Object Ergebnis, Job | Format-Table -AutoSize

$title = "[$status] Veeam-Bericht $Server - $($now.ToString('dd.MM.yyyy HH:mm'))"
$css   = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>'
$html  = $rows | Sort-Object Ergebnis, Job | ConvertTo-Html -Title $title -Head $css `
    -PreContent "<h2>$title</h2><p>$($rows.Count) Jobs in den letzten $Hours Stunden: $failed Fehler oder kein Lauf, $warning Warnungen.</p>" | Out-String
$html  = $html -replace '<td>Fehler</td>', '<td style="background:#f8d7da">Fehler</td>' `
               -replace '<td>Kein Lauf</td>', '<td style="background:#f8d7da">Kein Lauf</td>' `
               -replace '<td>Warnung</td>', '<td style="background:#fff3cd">Warnung</td>' `
               -replace '<td>Erfolg</td>', '<td style="background:#d4edda">Erfolg</td>'
$file  = Join-Path $ReportPath ("Veeam_{0:yyyy-MM-dd_HHmm}.html" -f $now)
$html | Set-Content -Path $file -Encoding UTF8
Write-Host "Bericht: $file"

if ($SmtpServer -and $From -and $To -and (-not $OnlyProblems -or $exit -gt 0)) {
    Send-MailMessage -SmtpServer $SmtpServer -From $From -To $To -Subject $title -Body $html -BodyAsHtml -Encoding UTF8
}

exit $exit