Get-ProxmoxBackupReport.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 57be437e-0326-5dba-9a19-711472b04ea0 .AUTHOR Torsten Weise .COMPANYNAME powerscripting.de .COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz. .TAGS Powerscripting German Homelab Linux PSEdition_Core Proxmox .LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt .PROJECTURI https://powerscripting.de/skripte/get-proxmoxbackupreport.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Zeigt für jede VM und jeden Container in Proxmox VE das letzte Backup und meldet ungesicherte Gäste. .DESCRIPTION Ein Backup-Job in Proxmox sichert genau die Gäste, die beim Anlegen ausgewählt waren. Eine VM, die danach dazukommt, bleibt ungesichert, wenn der Job nicht auf "Alle" oder einen Pool steht. Und ein Job, der seit Tagen auf einem vollen Datastore scheitert, fällt in der Weboberfläche kaum auf. Das Skript fragt die Proxmox-API mit einem API-Token ab und prüft: - welche Gäste in keinem Backup-Job enthalten sind (Proxmox liefert dafür eine eigene Liste), - wann jeder Gast zuletzt gesichert wurde, über alle Speicher mit Inhalt "backup" hinweg, auch Proxmox Backup Server, - ob die letzte Sicherung auf einem PBS verifiziert wurde. Bewertung pro Gast: - Kein Job: in keinem Backup-Job enthalten. - Kein Backup: Job vorhanden, aber keine Sicherung gefunden. - Veraltet: letzte Sicherung älter als -MaxAgeHours. - Verifikation fehlgeschlagen: PBS meldet einen Fehler bei der Prüfung der letzten Sicherung. - OK: aktuell gesichert. Vorlagen (Templates) werden übersprungen. Exitcode: 0 ohne Befund, 1 bei veralteten Sicherungen, 2 bei Gästen ohne Job, ohne Backup oder mit fehlgeschlagener Verifikation. .PARAMETER Server Adresse eines Proxmox-Knotens, z. B. pve.home.lan oder 192.168.178.4. Port 8006 wird ergänzt. .PARAMETER TokenId Token-ID in der Form Benutzer@Realm!Tokenname, z. B. monitor@pve!backupreport. .PARAMETER TokenSecret Geheimnis des Tokens (UUID). Ohne Angabe fragt das Skript danach. .PARAMETER MaxAgeHours Ab wie vielen Stunden eine Sicherung als veraltet gilt. Standard: 26. .PARAMETER SkipCertificateCheck Selbst signiertes Zertifikat von Proxmox akzeptieren. Besser ist ein gültiges Zertifikat per ACME. .PARAMETER ReportPath Ordner für HTML- und CSV-Bericht. Standard: aktueller Ordner. .EXAMPLE ./Get-ProxmoxBackupReport.ps1 -Server 192.168.178.4 -TokenId 'monitor@pve!backupreport' -SkipCertificateCheck Fragt nach dem Token-Geheimnis und erstellt den Bericht. .EXAMPLE ./Get-ProxmoxBackupReport.ps1 -Server pve.home.lan -TokenId 'monitor@pve!backupreport' -TokenSecret (Get-Content /root/.pve-token) -MaxAgeHours 50 Läuft ohne Rückfrage, etwa per Cron, und warnt erst nach gut zwei Tagen. .NOTES Autor: Torsten Weise, powerscripting.de Läuft mit PowerShell 7 unter Linux, macOS und Windows. Token anlegen: Datacenter > Berechtigungen > API Token, Benutzer z. B. monitor@pve, Rechtetrennung an. Dem Token die Rolle PVEAuditor auf Pfad / geben. Zeigt der Bericht keine Sicherungen, fehlt meist das Recht Datastore.Audit auf dem Backup-Speicher. Das Skript liest nur und ändert nichts. #> #Requires -Version 7.0 [CmdletBinding()] param( [Parameter(Mandatory)] [string] $Server, [Parameter(Mandatory)] [string] $TokenId, [string] $TokenSecret, [ValidateRange(1, 2160)] [int] $MaxAgeHours = 26, [switch] $SkipCertificateCheck, [string] $ReportPath = (Get-Location).Path ) if (-not $TokenSecret) { $sec = Read-Host -Prompt "Geheimnis für $TokenId" -AsSecureString $TokenSecret = [System.Net.NetworkCredential]::new('', $sec).Password } $base = if ($Server -match ':\d+$') { "https://$Server/api2/json" } else { "https://${Server}:8006/api2/json" } $hdr = @{ Authorization = "PVEAPIToken=$TokenId=$TokenSecret" } function Invoke-Pve([string] $Path) { $r = Invoke-RestMethod -Uri "$base$Path" -Headers $hdr -SkipCertificateCheck:$SkipCertificateCheck -TimeoutSec 60 -ErrorAction Stop return $r.data } $guests = @(Invoke-Pve '/cluster/resources?type=vm' | Where-Object { -not $_.template }) Write-Host "$($guests.Count) Gäste im Cluster" # Gäste ohne Backup-Job $noJob = @{} try { foreach ($g in @(Invoke-Pve '/cluster/backup-info/not-backed-up')) { $noJob[[int]$g.vmid] = $true } } catch { Write-Host "Liste der ungesicherten Gäste nicht abrufbar: $($_.Exception.Message)" -ForegroundColor Yellow } # Alle Sicherungen auf allen Backup-Speichern, gemeinsame Speicher nur einmal lesen $backups = @{} $seen = @{} foreach ($node in @(Invoke-Pve '/nodes' | Where-Object status -eq 'online')) { foreach ($st in @(Invoke-Pve "/nodes/$($node.node)/storage?content=backup&enabled=1")) { if ($st.shared -and $seen.ContainsKey($st.storage)) { continue } $seen[$st.storage] = $true try { $items = @(Invoke-Pve "/nodes/$($node.node)/storage/$($st.storage)/content?content=backup") } catch { Write-Host "Speicher $($st.storage) auf $($node.node) nicht lesbar: $($_.Exception.Message)" -ForegroundColor Yellow continue } foreach ($b in $items) { if (-not $b.vmid) { continue } $id = [int]$b.vmid if (-not $backups.ContainsKey($id) -or $b.ctime -gt $backups[$id].ctime) { $backups[$id] = [pscustomobject]@{ ctime = [long]$b.ctime; storage = $st.storage; size = [long]$b.size verify = if ($b.verification) { $b.verification.state } else { '' } } } } } } $epoch = [datetime]::new(1970, 1, 1, 0, 0, 0, [DateTimeKind]::Utc) $now = Get-Date $rows = foreach ($g in $guests) { $id = [int]$g.vmid $b = $backups[$id] $when = if ($b) { $epoch.AddSeconds($b.ctime).ToLocalTime() } else { $null } $age = if ($when) { [math]::Round(($now - $when).TotalHours, 1) } else { $null } $rating = if ($noJob[$id]) { 'Kein Job' } elseif (-not $b) { 'Kein Backup' } elseif ($b.verify -eq 'failed') { 'Verifikation fehlgeschlagen' } elseif ($age -gt $MaxAgeHours) { 'Veraltet' } else { 'OK' } [pscustomobject]@{ VMID = $id Name = $g.name Typ = if ($g.type -eq 'lxc') { 'Container' } else { 'VM' } Knoten = $g.node Status = $g.status Bewertung = $rating 'Letztes Backup' = if ($when) { $when.ToString('dd.MM.yyyy HH:mm') } else { '' } 'Alter (h)' = $age Speicher = if ($b) { $b.storage } else { '' } 'Größe GB' = if ($b) { [math]::Round($b.size / 1GB, 1) } else { $null } Verifikation = switch ($b.verify) { 'ok' { 'ok' } 'failed' { 'fehlgeschlagen' } default { '' } } } } $order = @{ 'Kein Job' = 0; 'Kein Backup' = 1; 'Verifikation fehlgeschlagen' = 2; 'Veraltet' = 3; 'OK' = 4 } $sorted = @($rows | Sort-Object @{ e = { $order[$_.Bewertung] } }, VMID) $sorted | Format-Table VMID, Name, Typ, Bewertung, 'Letztes Backup', 'Alter (h)', Speicher, Verifikation -AutoSize $stats = $sorted | Group-Object Bewertung | ForEach-Object { "$($_.Name): $($_.Count)" } Write-Host ($stats -join ' | ') $title = "Proxmox-Backups - $($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 = $sorted | ConvertTo-Html -Title $title -Head $css -PreContent "<h2>$title</h2><p>$($sorted.Count) Gäste. $($stats -join ', '). Veraltet ab $MaxAgeHours Stunden.</p>" | Out-String $html = $html -replace '<td>(Kein Job|Kein Backup|Verifikation fehlgeschlagen)</td>', '<td style="background:#f8d7da">$1</td>' ` -replace '<td>Veraltet</td>', '<td style="background:#fff3cd">Veraltet</td>' ` -replace '<td>OK</td>', '<td style="background:#d4edda">OK</td>' $file = Join-Path $ReportPath ("Proxmox-Backups_{0:yyyy-MM-dd}" -f $now) $html | Set-Content -Path "$file.html" -Encoding UTF8 $sorted | Export-Csv -Path "$file.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8 Write-Host "Bericht: $file.html und $file.csv" if (@($sorted | Where-Object { $_.Bewertung -in 'Kein Job', 'Kein Backup', 'Verifikation fehlgeschlagen' }).Count) { exit 2 } elseif (@($sorted | Where-Object Bewertung -eq 'Veraltet').Count) { exit 1 } else { exit 0 } |