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 } |