Get-MailboxForwardingReport.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 17315caf-0fc2-5bf2-a7e2-ca166e54abd2
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Microsoft365 M365 EntraID AzureAD Graph PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-mailboxforwardingreport.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Findet Postfächer in Exchange Online, die Mails nach außen weiterleiten, und verdächtige Posteingangsregeln.
 
.DESCRIPTION
    Wer ein Postfach übernommen hat, richtet als Erstes eine stille Weiterleitung ein. Das ist das klassische
    Muster bei Business E-Mail Compromise (BEC): Der Angreifer liest mit, ohne dass der Benutzer etwas merkt.
    Das Skript prüft drei Stellen:
    - Weiterleitung am Postfach (ForwardingSmtpAddress und ForwardingAddress), mit oder ohne Kopie im Postfach.
    - Posteingangsregeln, die weiterleiten oder umleiten (ForwardTo, ForwardAsAttachmentTo, RedirectTo).
    - Posteingangsregeln mit typischen Tarnmerkmalen: Mails löschen, als gelesen markieren oder in selten
      genutzte Ordner wie RSS-Feeds, Archiv oder Junk-E-Mail verschieben.
 
    Ein Ziel gilt als extern, wenn seine Domain keine akzeptierte Domain des Tenants ist. Zusätzlich zeigt das
    Skript, wie die Richtlinien für ausgehenden Spam die automatische Weiterleitung regeln. Steht dort "On",
    kommen externe Weiterleitungen auch tatsächlich an.
 
    Die Prüfung der Posteingangsregeln fragt jedes Postfach einzeln ab und dauert bei großen Tenants lange.
    Mit -SkipInboxRules prüft das Skript nur die Weiterleitungen am Postfach.
 
    Exitcode: 0 ohne Befund, 1 bei verdächtigen Regeln ohne externes Ziel, 2 bei externer Weiterleitung.
 
.PARAMETER Mailbox
    Optional. Nur diese Postfächer prüfen (Anmeldename oder Mailadresse). Standard: alle Benutzer- und
    freigegebenen Postfächer.
 
.PARAMETER SkipInboxRules
    Posteingangsregeln nicht prüfen. Deutlich schneller.
 
.PARAMETER ReportPath
    Ordner für HTML- und CSV-Bericht. Standard: aktueller Ordner.
 
.EXAMPLE
    .\Get-MailboxForwardingReport.ps1
 
    Meldet sich an Exchange Online an und prüft alle Benutzer- und freigegebenen Postfächer.
 
.EXAMPLE
    .\Get-MailboxForwardingReport.ps1 -Mailbox anna.schmidt@contoso.de, buchhaltung@contoso.de
 
    Prüft gezielt zwei Postfächer, etwa nach einer Phishing-Meldung.
 
.EXAMPLE
    .\Get-MailboxForwardingReport.ps1 -SkipInboxRules | Where-Object Extern -eq 'Ja'
 
    Gibt nur die Postfächer mit externer Weiterleitung als Objekte aus.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Benötigt: Install-Module ExchangeOnlineManagement -Scope CurrentUser
    Rolle: Global Reader, Security Reader oder View-Only Organization Management reicht.
    Das Skript liest nur und ändert nichts. Gefundene Weiterleitungen entfernst du von Hand, nachdem du mit
    dem Benutzer gesprochen hast: Eine Weiterleitung kann gewollt sein.
#>

#Requires -Modules ExchangeOnlineManagement
[CmdletBinding()]
param(
    [string[]] $Mailbox,
    [switch] $SkipInboxRules,
    [string] $ReportPath = (Get-Location).Path
)

if (-not (Get-ConnectionInformation -ErrorAction SilentlyContinue)) {
    Connect-ExchangeOnline -ShowBanner:$false -ErrorAction Stop
}

$accepted = @(Get-AcceptedDomain | ForEach-Object { $_.DomainName.ToString().ToLower() })

function Test-External([string] $Address) {
    if (-not $Address) { return $false }
    $a = $Address -replace '^(smtp|SMTP):', ''
    if ($a -notmatch '@') { return $false }   # interner Empfänger als Anzeigename oder DN
    $domain = ($a -split '@')[-1].Trim('>', ' ', '"').ToLower()
    return $domain -notin $accepted
}

function Get-RuleTargets($Rule) {
    foreach ($prop in 'ForwardTo', 'ForwardAsAttachmentTo', 'RedirectTo') {
        foreach ($t in @($Rule.$prop)) {
            if ($t) {
                # Format: "Name" [SMTP:adresse@domain] oder nur der Anzeigename bei internen Empfängern
                $m = [regex]::Match([string]$t, '(?i)smtp:([^\]\s]+)')
                if ($m.Success) { $m.Groups[1].Value } else { [string]$t }
            }
        }
    }
}

# Postfächer laden
$props = 'ForwardingSmtpAddress', 'ForwardingAddress', 'DeliverToMailboxAndForward', 'RecipientTypeDetails'
$boxes = if ($Mailbox) {
    foreach ($m in $Mailbox) { Get-EXOMailbox -Identity $m -Properties $props -ErrorAction Stop }
} else {
    Get-EXOMailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox, SharedMailbox -Properties $props
}
$boxes = @($boxes)
Write-Host "$($boxes.Count) Postfächer werden geprüft"

$rows = [System.Collections.Generic.List[object]]::new()

foreach ($b in $boxes) {
    # 1. Weiterleitung am Postfach
    foreach ($fwd in @($b.ForwardingSmtpAddress, $b.ForwardingAddress)) {
        if (-not $fwd) { continue }
        $target = [string]$fwd
        if ($fwd -eq $b.ForwardingAddress) {
            # ForwardingAddress zeigt auf einen Empfänger im Verzeichnis, z. B. einen E-Mail-Kontakt
            $r = Get-EXORecipient -Identity $target -ErrorAction SilentlyContinue
            if ($r) { $target = [string]$r.PrimarySmtpAddress }
        }
        $rows.Add([pscustomobject]@{
            Postfach  = $b.UserPrincipalName
            Typ       = $b.RecipientTypeDetails
            Quelle    = 'Weiterleitung am Postfach'
            Regel     = ''
            Ziel      = ($target -replace '^(smtp|SMTP):')
            Extern    = if (Test-External $target) { 'Ja' } else { 'Nein' }
            Kopie     = if ($b.DeliverToMailboxAndForward) { 'Ja' } else { 'Nein, Mails landen nur beim Ziel' }
            Hinweis   = ''
        })
    }

    # 2. und 3. Posteingangsregeln
    if ($SkipInboxRules) { continue }
    $rules = @(Get-InboxRule -Mailbox $b.UserPrincipalName -ErrorAction SilentlyContinue)
    foreach ($rule in $rules) {
        if (-not $rule.Enabled) { continue }
        $targets = @(Get-RuleTargets $rule)
        $flags = @()
        if ($rule.DeleteMessage -or $rule.SoftDeleteMessage) { $flags += 'löscht Mails' }
        if ($rule.MarkAsRead) { $flags += 'markiert als gelesen' }
        if ($rule.MoveToFolder -match '(?i)RSS|Archiv|Archive|Junk|Conversation History|Unterhaltungsverlauf') {
            $flags += "verschiebt nach '$($rule.MoveToFolder)'"
        }
        if ($rule.StopProcessingRules -and ($flags -or $targets)) { $flags += 'stoppt weitere Regeln' }
        if ($rule.Name -match '^[\W_.]{1,3}$') { $flags += 'Name ohne Buchstaben' }

        if (-not $targets -and $flags.Count -lt 2) { continue }   # einzelnes Merkmal ist meist harmlos

        $list = if ($targets) { $targets } else { @('') }
        foreach ($t in $list) {
            $rows.Add([pscustomobject]@{
                Postfach = $b.UserPrincipalName
                Typ      = $b.RecipientTypeDetails
                Quelle   = 'Posteingangsregel'
                Regel    = $rule.Name
                Ziel     = $t
                Extern   = if (Test-External $t) { 'Ja' } else { 'Nein' }
                Kopie    = ''
                Hinweis  = $flags -join ', '
            })
        }
    }
}

# Richtlinien für ausgehenden Spam: Wer darf automatisch weiterleiten?
$policies = Get-HostedOutboundSpamFilterPolicy | Select-Object Name, AutoForwardingMode, IsDefault
Write-Host ''
Write-Host 'Automatische Weiterleitung laut Richtlinie für ausgehenden Spam:'
foreach ($p in $policies) {
    $txt = switch ($p.AutoForwardingMode) {
        'Off'       { 'gesperrt' }
        'On'        { 'erlaubt' }
        'Automatic' { 'automatisch (wird von Microsoft wie "gesperrt" behandelt)' }
        default     { $p.AutoForwardingMode }
    }
    $col = if ($p.AutoForwardingMode -eq 'On') { 'Red' } else { 'Gray' }
    Write-Host (" {0}{1}: {2}" -f $p.Name, $(if ($p.IsDefault) { ' (Standard)' } else { '' }), $txt) -ForegroundColor $col
}

$sorted = @($rows | Sort-Object @{ e = { $_.Extern -ne 'Ja' } }, Postfach)
$sorted

$external = @($sorted | Where-Object Extern -eq 'Ja').Count
$suspect  = @($sorted | Where-Object { $_.Extern -ne 'Ja' -and $_.Hinweis }).Count
Write-Host ''
Write-Host "Externe Ziele: $external | Verdächtige Regeln ohne externes Ziel: $suspect | Einträge gesamt: $($sorted.Count)"

$now   = Get-Date
$title = "Weiterleitungen und Posteingangsregeln - $($now.ToString('dd.MM.yyyy'))"
$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;vertical-align:top}th{background:#eee}</style>'
$pol   = ($policies | ForEach-Object { "$($_.Name): $($_.AutoForwardingMode)" }) -join ', '
$pre   = "<h2>$title</h2><p>$($boxes.Count) Postfächer geprüft. Externe Ziele: $external. Verdächtige Regeln: $suspect.</p><p>Richtlinie automatische Weiterleitung: $pol</p>"
$html  = if ($sorted.Count) {
    $sorted | ConvertTo-Html -Title $title -Head $css -PreContent $pre | Out-String
} else {
    ConvertTo-Html -Title $title -Head $css -PreContent "$pre<p>Keine Weiterleitungen oder verdächtigen Regeln gefunden.</p>" | Out-String
}
$html  = $html -replace '<td>Ja</td>', '<td style="background:#f8d7da">Ja</td>'
$base  = Join-Path $ReportPath ("Weiterleitungen_{0:yyyy-MM-dd}" -f $now)
$html | Set-Content -Path "$base.html" -Encoding UTF8
$sorted | Export-Csv -Path "$base.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8
Write-Host "Bericht: $base.html und $base.csv"

if ($external) { exit 2 } elseif ($suspect) { exit 1 } else { exit 0 }