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 }