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 |