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
}