Get-MailboxDatabaseReport.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 3756dae0-cb75-58cd-a7d4-b51cdddd8c21 .AUTHOR Torsten Weise .COMPANYNAME powerscripting.de .COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz. .TAGS Powerscripting German Exchange ExchangeOnline Mailbox PSEdition_Desktop PSEdition_Core .LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt .PROJECTURI https://powerscripting.de/skripte/get-mailboxdatabasereport.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES Exchange Management Shell .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Erstellt einen HTML-Bericht über alle Exchange-Postfachdatenbanken: Größe, Leerraum, Postfächer und freier Plattenplatz. .DESCRIPTION Liest für jede Postfachdatenbank aus: - Größe der Datenbankdatei und darin enthaltener Leerraum (AvailableNewMailboxSpace) - Anzahl der Postfächer - Freier und gesamter Platz auf dem Laufwerk mit der Datenbank - Letzte Vollsicherung Der Bericht wird als HTML-Datei gespeichert und auf Wunsch per Mail verschickt. Datenbanken, deren Laufwerk weniger als -WarnPercentFree Prozent frei hat, werden rot markiert. Läuft in der Exchange Management Shell (Exchange Server 2016, 2019 und Subscription Edition). .PARAMETER ReportPath Ordner für den HTML-Bericht. Standard: aktueller Ordner. .PARAMETER WarnPercentFree Schwelle für die Warnung bei freiem Plattenplatz in Prozent. Standard: 15. .PARAMETER SmtpServer Optional. Mailserver für den Versand. .PARAMETER From Absender des Berichts. .PARAMETER To Empfänger des Berichts. .EXAMPLE .\Get-MailboxDatabaseReport.ps1 .EXAMPLE .\Get-MailboxDatabaseReport.ps1 -SmtpServer mail.contoso.local -From exchange-report@contoso.local -To it@contoso.local .NOTES Autor: Torsten Weise, powerscripting.de Der Plattenplatz wird per CIM vom Postfachserver gelesen. Dafür braucht das ausführende Konto Leserechte per WinRM. #> [CmdletBinding()] param( [string] $ReportPath = (Get-Location).Path, [ValidateRange(1, 99)] [int] $WarnPercentFree = 15, [string] $SmtpServer, [string] $From, [string[]] $To ) if (-not (Get-Command Get-MailboxDatabase -ErrorAction SilentlyContinue)) { throw 'Dieses Skript muss in der Exchange Management Shell laufen.' } $rows = foreach ($db in Get-MailboxDatabase -Status | Sort-Object Name) { $server = $db.Server.Name $drive = $db.EdbFilePath.DriveName $disk = $null try { $disk = Get-CimInstance -ComputerName $server -ClassName Win32_Volume -ErrorAction Stop | Where-Object { $_.Name -and $db.EdbFilePath.PathName.StartsWith($_.Name, 'OrdinalIgnoreCase') } | Sort-Object { $_.Name.Length } -Descending | Select-Object -First 1 } catch { Write-Warning "Plattenplatz von $server nicht lesbar: $($_.Exception.Message)" } $mailboxes = @(Get-Mailbox -Database $db.Identity -ResultSize Unlimited -WarningAction SilentlyContinue).Count [pscustomobject]@{ Datenbank = $db.Name Server = $server Eingebunden = $db.Mounted 'Größe (GB)' = [math]::Round($db.DatabaseSize.ToBytes() / 1GB, 2) 'Leerraum (GB)' = [math]::Round($db.AvailableNewMailboxSpace.ToBytes() / 1GB, 2) 'Postfächer' = $mailboxes Laufwerk = if ($disk) { $disk.Name } else { $drive } 'Frei (GB)' = if ($disk) { [math]::Round($disk.FreeSpace / 1GB, 2) } else { $null } 'Gesamt (GB)' = if ($disk) { [math]::Round($disk.Capacity / 1GB, 2) } else { $null } 'Frei (%)' = if ($disk) { [math]::Round($disk.FreeSpace / $disk.Capacity * 100, 1) } else { $null } 'Letzte Vollsicherung' = if ($db.LastFullBackup) { $db.LastFullBackup.ToString('dd.MM.yyyy HH:mm') } else { 'nie' } } } $rows | Format-Table -AutoSize $date = Get-Date $title = 'Exchange Datenbankbericht - {0:dd.MM.yyyy}' -f $date $style = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse}' + 'th,td{border:1px solid #ccc;padding:4px 8px;text-align:right}th{background:#eee}td:first-child{text-align:left}' + '.warn{background:#fdd}</style>' $html = $rows | ConvertTo-Html -Title $title -Head $style -PreContent "<h2>$title</h2>" | Out-String # Zeilen mit zu wenig freiem Platz markieren foreach ($r in $rows | Where-Object { $_.'Frei (%)' -ne $null -and $_.'Frei (%)' -lt $WarnPercentFree }) { $html = $html -replace "<tr><td>$([regex]::Escape($r.Datenbank))</td>", "<tr class=`"warn`"><td>$($r.Datenbank)</td>" } $file = Join-Path $ReportPath ('Exchange-Datenbanken_{0:yyyy-MM-dd}.html' -f $date) $html | Set-Content -Path $file -Encoding UTF8 Write-Host "Bericht: $file" if ($SmtpServer -and $From -and $To) { Send-MailMessage -SmtpServer $SmtpServer -From $From -To $To -Subject $title -Body $html -BodyAsHtml -Encoding UTF8 } |