Get-DiskSpaceReport.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 5e64606c-dbe9-5df9-870c-2b5819b65a98
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Monitoring Report Windows Backup PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-diskspacereport.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES ActiveDirectory
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Zeigt den freien Speicherplatz aller lokalen Laufwerke auf mehreren Servern und markiert knappe Laufwerke.
 
.DESCRIPTION
    Fragt per CIM (WinRM) die Festplattenlaufwerke der angegebenen Rechner ab: Größe, belegt, frei und
    frei in Prozent. Laufwerke unter -WarningPercent gelten als Warnung, unter -CriticalPercent als
    kritisch. Zusätzlich lässt sich eine absolute Grenze in GB setzen, damit große Volumes mit wenigen
    Prozent, aber reichlich Platz nicht dauernd anschlagen.
 
    Ohne -ComputerName werden alle aktivierten Windows-Server aus dem Active Directory geprüft
    (benötigt das ActiveDirectory-Modul). Das Ergebnis erscheint als Tabelle, als HTML-Bericht mit
    Balken und auf Wunsch per Mail. Exitcode 0, 1 (Warnung) oder 2 (Kritisch).
 
.PARAMETER ComputerName
    Zu prüfende Rechner. Ohne Angabe: alle Windows-Server aus dem AD.
 
.PARAMETER WarningPercent
    Grenze für Warnung in Prozent freiem Platz. Standard: 15.
 
.PARAMETER CriticalPercent
    Grenze für Kritisch in Prozent freiem Platz. Standard: 8.
 
.PARAMETER MinFreeGB
    Laufwerke mit mindestens so viel freiem Platz gelten immer als OK. Standard: 100.
 
.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 Laufwerk knapp ist.
 
.EXAMPLE
    .\Get-DiskSpaceReport.ps1 -ComputerName DC01, FS01, SQL01
 
    Prüft drei Server mit den Standardgrenzen.
 
.EXAMPLE
    .\Get-DiskSpaceReport.ps1 -WarningPercent 20 -SmtpServer mail.contoso.local -From disk@contoso.local -To it@contoso.local -OnlyProblems
 
    Prüft alle Server aus dem AD und meldet sich nur, wenn es eng wird.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Benötigt WinRM auf den Zielrechnern (bei Windows Server Standard). Ältere Systeme ohne WinRM
    lassen sich mit New-CimSessionOption -Protocol Dcom abfragen.
#>

[CmdletBinding()]
param(
    [string[]] $ComputerName,
    [ValidateRange(1, 99)] [int] $WarningPercent = 15,
    [ValidateRange(1, 99)] [int] $CriticalPercent = 8,
    [int] $MinFreeGB = 100,
    [string] $ReportPath = (Get-Location).Path,
    [string] $SmtpServer,
    [string] $From,
    [string[]] $To,
    [switch] $OnlyProblems
)

if (-not $ComputerName) {
    Import-Module ActiveDirectory -ErrorAction Stop
    $ComputerName = Get-ADComputer -Filter 'OperatingSystem -like "*Server*" -and Enabled -eq $true' |
        Select-Object -ExpandProperty DNSHostName | Sort-Object
    Write-Host "$($ComputerName.Count) Server aus dem AD"
}

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

foreach ($computer in $ComputerName) {
    try {
        $disks = Get-CimInstance -ClassName Win32_LogicalDisk -Filter 'DriveType = 3' -ComputerName $computer -OperationTimeoutSec 15 -ErrorAction Stop
        foreach ($d in $disks) {
            if (-not $d.Size) { continue }
            $freeGB  = [math]::Round($d.FreeSpace / 1GB, 1)
            $sizeGB  = [math]::Round($d.Size / 1GB, 1)
            $percent = [math]::Round(100 * $d.FreeSpace / $d.Size, 1)
            $rating  = if ($freeGB -ge $MinFreeGB) { 'OK' }
                       elseif ($percent -lt $CriticalPercent) { 'Kritisch' }
                       elseif ($percent -lt $WarningPercent) { 'Warnung' }
                       else { 'OK' }
            $rows.Add([pscustomobject]@{
                Server = $computer; Laufwerk = $d.DeviceID; Name = $d.VolumeName; Bewertung = $rating
                'Größe GB' = $sizeGB; 'Frei GB' = $freeGB; 'Frei %' = $percent
            })
        }
    }
    catch {
        $rows.Add([pscustomobject]@{ Server = $computer; Laufwerk = ''; Name = $_.Exception.Message
            Bewertung = 'Nicht erreichbar'; 'Größe GB' = ''; 'Frei GB' = ''; 'Frei %' = '' })
    }
}

$order  = @{ 'Kritisch' = 0; 'Warnung' = 1; 'Nicht erreichbar' = 2; 'OK' = 3 }
$sorted = $rows | Sort-Object { $order[$_.Bewertung] }, Server, Laufwerk
$crit   = @($rows | Where-Object Bewertung -eq 'Kritisch').Count
$warn   = @($rows | Where-Object { $_.Bewertung -in 'Warnung', 'Nicht erreichbar' }).Count
$status = if ($crit) { 'KRITISCH' } elseif ($warn) { 'WARNUNG' } else { 'OK' }
$exit   = if ($crit) { 2 } elseif ($warn) { 1 } else { 0 }

$sorted | Format-Table -AutoSize

# HTML mit Balken, die Farbe zeigt die Bewertung
$colors = @{ 'Kritisch' = '#dc3545'; 'Warnung' = '#ffc107'; 'OK' = '#28a745'; 'Nicht erreichbar' = '#6c757d' }
$trs = foreach ($r in $sorted) {
    $used = if ($r.Laufwerk) { 100 - $r.'Frei %' } else { 0 }
    $bar  = "<div style='background:#e9ecef;width:160px;height:12px'><div style='background:$($colors[$r.Bewertung]);width:$([int]($used * 1.6))px;height:12px'></div></div>"
    "<tr><td>$($r.Server)</td><td>$($r.Laufwerk)</td><td>$([Net.WebUtility]::HtmlEncode($r.Name))</td><td>$($r.Bewertung)</td><td>$bar</td><td>$($r.'Frei GB')</td><td>$($r.'Größe GB')</td><td>$($r.'Frei %')</td></tr>"
}
$title = "[$status] Speicherplatz - $($now.ToString('dd.MM.yyyy HH:mm'))"
$html  = @"
<html><head><meta charset="utf-8"><title>$title</title>
<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></head>
<body><h2>$title</h2><p>$($ComputerName.Count) Rechner, $crit Laufwerke kritisch, $warn mit Warnung. Grenzen: $WarningPercent % / $CriticalPercent %, ab $MinFreeGB GB frei immer OK.</p>
<table><tr><th>Server</th><th>LW</th><th>Name</th><th>Bewertung</th><th>Belegt</th><th>Frei GB</th><th>Größe GB</th><th>Frei %</th></tr>
$($trs -join "`n")
</table></body></html>
"@

$file = Join-Path $ReportPath ("Speicherplatz_{0:yyyy-MM-dd}.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