Postfächer aus Microsoft 365 in eine PST-Datei exportieren mit PowerShell

Diese Option gibt es in Exchange Online leider nicht, hier soll man stattdessen das Microsoft Compliance Center (früher "Security und Compliance") nutzen (siehe dazu: Postfächer aus Office 365 in PST-Dateien exportieren).

Eine Automatisierung des Vorgangs ist über die Web-Oberfläche jedoch nicht möglich, aber dafür lässt sich der gleiche Workflow in PowerShell abbilden. Im nachfolgenden Script zeige ich anhand meines Postfaches, wie ein solcher Export aussehen könnte.

Compliance Center über PowerShell ansprechen

Dabei bediene ich mich zum einen der Cmdlets des Microsoft Compliance Centers als auch der eDiscovery Export Tools, welche sich ebenfalls über PowerShell steuern lassen.

Voraussetzung dafür ist das Exchange-Online-Modul möglichst in der neuesten Fassung (aktuell ist dies die V3) mit einem Connect zum Microsoft Compliance Center.

Hinweis: Wenn Sie das Script automatisch ausführen möchten, dann empfiehlt es sich, die Verbindung mit einer App-Registrierung (App-ID und Zertifikats­finger­abdruck) zu konfigurieren. Andernfalls müssen Sie sich bei jeder Script-Ausführung im Microsoft-Tenant anmelden.

Zuerst stellt man die Verbindung zum Microsoft Compliance Center via Benutzerkonto her:

Import-Module ExchangeOnlineManagement
Connect-IPPSSession

Compliance-Suche ausführen

Nun folgen im Prinzip die gleichen Schritte wie bei einem Export über die GUI, nämlich ein Compliance Search und danach eine Compliance­Search­Action:

New-ComplianceSearch "Roland-Export" `
-ExchangeLocation <Postfach-für-Export> |
Start-ComplianceSearch

New-ComplianceSearchAction -SearchName "Roland-Export" `
-Export -Format Fxstream

"Roland-Export" steht hier als Platzhalter für den Namen der Suche, damit diese in den nächsten Schritten wiedergefunden werden kann.

Mit

Get-ComplianceSearchAction "Roland-Export_Export" -IncludeCredential |
Format-List

kann man nun den Status der vorausgegangenen Befehle kontrollieren. Das Suffix "_Export" wird von New-ComplianceSearchAction automatisch an den SearchName angehängt.

Hinweis: Mit einem Get-ComplianceSearchAction kann man alle Suchaktionen einsehen.

Wichtig ist in der Ausgabe dieses Befehls das Attribut Status. Dieses muss auf Completed stehen, da ansonsten die Search-Aktion noch nicht fertig ist und ein Export nicht funktionieren würde. Zudem benötigt man für den Export die Container-URL und das SAS-Token.

Export-Tool starten

Im nächsten Schritt nutzen wir das eDiscovery Export-Tool. Dieses legt sich automatisch im Benutzerprofil eines Users ab, sobald er einen Export via GUI durchführt.

$SearchName = "Roland-Export" $ExportLocation = "\\localhost\Temp" $ExportExe = ((Get-ChildItem -Path ("C:\Users\roland.eich\AppData\Local\Apps\2.0") -Filter microsoft.office.client.discovery.unifiedexporttool.exe -Recurse).FullName | Where-Object{ $_ -notmatch "_none_" } | Select-Object -First 1) $ExportName = $SearchName + "_Export" $ExportDetails = Get-ComplianceSearchAction -Identity $ExportName -IncludeCredential -Details $ExportDetails = $ExportDetails.Results.split(";") $ExportContainerUrl = $ExportDetails[0].trimStart("Container url: ") $ExportSasToken = $ExportDetails[1].trimStart(" SAS token: ") $Arguments = "-name ""$SearchName""","-source ""$ExportContainerUrl""","-key ""$ExportSasToken""","-dest ""$ExportLocation""","-trace true" Start-Process -FilePath "$ExportExe" -ArgumentList $Arguments

Das Export-Tool erstellt nun unter dem Zielverzeichnis einen Exportordner und befüllt diesen.

Ein Vorteil gegenüber der Exportmethode von Exchange on-prem ist, dass diese hier wesentlich mehr Logs schreibt. Jede Aktion wie zum Beispiel Fehler, defekte Elemente etc. kann hier in den Protokollen nachvollzogen werden. Die eigentliche PST-Datei findet sich im Ordner Exchange.

Über den Task-Manager ist zu sehen, wie der Client im Hintergrund den Export abarbeitet.

Nachdem der Export abgeschlossen ist, sollte man nicht vergessen, die Search Action im Microsoft Compliance Center wieder zu löschen. Dies kann man ebenfalls via PowerShell tun:

Remove-ComplianceSearchAction "Roland-Export_Export"

Remove-ComplianceSearch "Roland-Export"

Zusammenfassung

Exchange Online bietet zwar kein Cmdlet analog zu jenem von Exchange Server, um Postfächer in eine PST-Datei zu exportieren. Dafür kann man aber den Export über die GUI des Compliance Center in PowerShell nachvollziehen und auf diese Weise automatisieren.

Soll der Export ohne Benutzereingriff erfolgen, dann kann man das Script über eine App-Registrierung an Microsoft 365 anmelden.