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 |