Konfiguration und Voraussetzungen im Überblick
Das Exchange-Team hat am 9. November 2026 angekündigt, dass der Mailbox Replication Service (MRS) von Microsoft 365 jetzt OAuth unterstützt, wenn du Postfächer zwischen Exchange Server und Exchange Online verschiebst. Das gilt für Hybrid- und Nicht-Hybrid-Umgebungen.
Bisher meldete sich der MRS am MRS Proxy per Basic Authentication mit den Anmeldedaten an, die im Migrationsendpunkt hinterlegt sind. Mit OAuth meldet sich der MRS stattdessen über eine eigene App-Identität in Microsoft Entra ID an, und Exchange Server prüft das Token gegen eine Liste autorisierter Einträge.
Basic Authentication bleibt erlaubt. Microsoft beschreibt OAuth ausdrücklich als optionale Alternative, nicht als Ersatz. Bestehende Endpunkte und laufende Migrationen sind nicht betroffen, und es gibt laut Ankündigung keinen Handlungsbedarf. Ein Abschaltdatum für Basic Auth am MRS Proxy nennt Microsoft nicht.
Voraussetzungen
Die Funktion steht in der weltweiten Multi-Tenant-Umgebung von Microsoft 365 bereit. Für andere Clouds kündigt das Exchange-Team Neuigkeiten in den nächsten Monaten an. On-Premises brauchst du eine dieser Versionen:
- Exchange Server Subscription Edition (SE) im Stand Oktober 2026 oder neuer
- Exchange Server 2019 CU15 mit dem aktuellen ESU vom Oktober 2026
Dazu kommen Zugriff auf Microsoft Entra ID als Tenant-Admin sowie eine on-premises Domäne, die im Tenant registriert ist und für die Migration genutzt wird. Für die PowerShell-Schritte brauchst du das Microsoft-Graph-PowerShell-Modul, die Exchange Management Shell und das Modul Exchange Online PowerShell.
Wichtig für die Einordnung: Das Verfahren ist nicht Hybrid Modern Authentication. HMA regelt die Anmeldung der Benutzer. Der OAuth-Endpunkt für MRS nutzt ein getrenntes, app-basiertes Autorisierungsmodell, das an die Object ID des MRS-Service-Principals in deinem Tenant gebunden ist.
Schritt für Schritt
1: On-Premises-API in Entra ID registrieren
Im Microsoft Entra Admin Center öffnest du App registrations und legst über New registration eine neue App an. Als unterstützten Kontotyp wählst du Single tenant only.
In der App wählst du Add an Application ID URI. Die URI muss komplett in Kleinbuchstaben stehen. Du kannst die URI deines bisherigen Migrationsendpunkts übernehmen oder das von Microsoft empfohlene Schema mit der Application (client) ID verwenden:
https://[Application (client) ID].contoso.com/ews/mrsproxy.svcDie Domäne in der URI muss in deinem Entra-Tenant registriert sein.
Unter API permissions entfernst du über das Menü neben Microsoft Graph alle Berechtigungen mit Remove all permissions. Danach legst du unter App roles mit Create an app role eine Rolle an. Microsoft verwendet im Beispiel den Anzeigenamen „MRS Onprem Onboarding“ und den Wert MRS.Onprem.Onboarding. Als Allowed member types wählst du Applications und aktivierst die Rolle.
Unter Token configuration fügst du einen optionalen Claim für den Tokentyp Access hinzu und aktivierst idtyp.
Im Manifest prüfst du, dass optionalClaims.accessToken den Eintrag idtyp enthält, und ergänzt einen zweiten Eintrag:
{
"additionalProperties": [],
"essential": false,
"name": "xms_aud_guid",
"source": null
}Nach dem Speichern stehen in accessToken genau zwei Einträge: idtyp und xms_aud_guid.
2: MRS-Service-Principal anlegen und Rolle zuweisen
Der Mailbox Replication Service von Microsoft 365 hat die feste App ID dbcda063-249e-42b8-84a1-5c1b9298c1f3.
Mit Microsoft Graph PowerShell legst du dafür einen Service Principal in deinem Tenant an:
Connect-MgGraph
$spn1P = New-MgServicePrincipal -AppId dbcda063-249e-42b8-84a1-5c1b9298c1f3
$spn1P | fl DisplayName, AppDisplayName, AppId, Id, ServicePrincipalNames, ServicePrincipalType, AppOwnerOrganizationIdAls DisplayName erscheint „Mailbox Replication Service“. Die ausgegebene Id ist die Object ID, die du später auf Exchange Server brauchst. Anschließend weist du diesem Service Principal die App-Rolle deiner On-Premises-API zu.
Application (client) ID und den Wert der App-Rolle kopierst du vorher aus dem Entra Admin Center:
$appId = "Application (client) ID"
$role = "App role Value"
$app = Get-MgApplication -Filter "AppId eq '$appId'"
$appRole = $app.AppRoles | ?{$_.Value -eq $role}
$spn1P = Get-MgServicePrincipalByAppId -AppId 'dbcda063-249e-42b8-84a1-5c1b9298c1f3'
$spnApp = Get-MgServicePrincipalByAppId -AppId $appId
$entry = New-MgServicePrincipalAppRoleAssignedTo -ResourceId $spnApp.Id -ServicePrincipalId $spnApp.Id -AppRoleId $appRole.Id -PrincipalId $spn1P.Id
$entry | fl AppRoleId, PrincipalDisplayName, PrincipalId, PrincipalType, ResourceDisplayName, ResourceIdSteht bei PrincipalDisplayName „Mailbox Replication Service“, sitzt die Zuweisung.
3: Exchange Server konfigurieren
Die folgenden Befehle laufen in der Exchange Management Shell auf einem Server mit aktuellem Build. Zuerst aktivierst du OAuth für den MRS Proxy und hinterlegst den autorisierten Eintrag. Er besteht aus vier Werten, getrennt durch einen senkrechten Strich: Tenant ID, Object ID des MRS-Service-Principals, Audience (die vollständige Application ID URI) und Rollenwert. Audience und Rolle sind case-sensitive.
New-SettingOverride -Name "OAuth MRS Settings" -Component "Mrs" -Section MRSProxyServiceOAuth -Parameters ("Enabled=true","AuthorizedEntries=$TenantID|$ObjectID|$Audience|$Role") -Reason "Enabling MRS Proxy OAuth"Mehrere Einträge trennst du durch Komma, jede Audience darf nur einmal vorkommen.
Danach prüfst du, ob es schon eine Audience-Validierung gibt, und nimmst die Application ID deiner neuen App dazu.
Vorhandene Werte musst du dabei mitgeben, sonst gehen sie verloren:
Get-SettingOverride -Component OAuth -Name AudGuidValidation
New-SettingOverride -Name AudGuidValidation -Parameters @("Enabled=true", "AdditionalApplicationIds=[vorhandene Werte],[Application (client) ID]") -Component OAuth -Section "AppIdBasedAudienceValidation" -Reason "Allowing MRS API App"
Zuletzt schaltest du OAuth auf den Frontend-Diensten frei:
New-SettingOverride -Name "Enable CAFE MRS OAuth" -Component Cafe -Section "OAuthAuthorizationInCAT" -Reason "Enable CAFE MRS OAuth" -Parameters "Enabled=true"
Mit Exchange Server SE verlangt Microsoft zusätzlich cookie-basierte Session Affinity am Load Balancer, beschrieben als Szenario C „Single namespace with session affinity, Layer 7“ im Artikel zum Load Balancing in Exchange Server. Für Exchange 2019 CU15 ist das laut Dokumentation nicht nötig.
Für die ersten Migrationen lohnt sich das Protokoll:
New-SettingOverride -Name "MRS OAuthLogging Settings" -Component "Mrs" -Section MRSProxyAuthLogging -Parameters ("Enabled=true") -Reason "Enabling MRS Proxy OAuth Logging"Die Logs liegen unter C:\Program Files\Microsoft\Exchange Server\V15\Logging\MrsProxyAuthorization. Die erste Prüfstufe auf den CAFE-Diensten protokolliert unter ...\V15\Logging\HttpProxy\Ews. Wenn du später mit Set-SettingOverride weitere Logoptionen setzt, überschreibt der Befehl alle bisherigen Parameter des Overrides. Gib deshalb immer den vollständigen Satz an.
4: Endpunkt in Exchange Online anlegen
In Exchange Online PowerShell legst du den Endpunkt mit dem neuen Schalter -UseOAuth an. -RemoteServer muss dem Hostnamen aus der Application ID URI entsprechen:
Connect-ExchangeOnline
$remoteServer = "mail.contoso.com"
New-MigrationEndpoint -UseOAuth -Name "OAuthEndpoint" -RemoteServer $remoteServer -ExchangeRemoteMove
Test-MigrationServerAvailability -Endpoint "OAuthEndpoint"Der Test holt ein OAuth-Token und zeigt dir, ob die Kette aus Entra ID, CAFE und MRS Proxy funktioniert. Danach verwendest du den Endpunkt wie jeden anderen, in Migrationsbatches oder direkt in Move Requests:
New-MigrationBatch -Name MyBatch -SourceEndpoint "OAuthEndpoint"
New-MoveRequest -Identity "user@contoso.com" -TargetDeliveryDomain contoso.com -SourceEndpoint "OAuthEndpoint" -RemoteHostName $remoteServer -Remote -ArchiveDomain contoso.comEinordnung
Der Aufwand liegt fast komplett in Schritt 1 und 3. Dafür entfallen Benutzername und Kennwort, die bisher im Endpunkt hinterlegt waren. Wer gerade Onboarding plant oder noch Postfächer zurückmigriert, kann den OAuth-Endpunkt parallel zum bestehenden Basic-Endpunkt aufbauen und mit Test-MigrationServerAvailability prüfen, bevor er Batches umstellt. Ohne Exchange SE im Oktober-Stand oder Exchange 2019 CU15 mit Oktober-ESU funktioniert keiner der Server-Schritte.
weitere Links
| Quelle | URL |
| Exchange Team Blog: Now available: OAuth authentication for on-premises Exchange mailbox migrations to Microsoft 365 (09.11.2026) | https://techcommunity.microsoft.com/blog/exchange/now-available-oauth-authentication-for-on-premises-exchange-mailbox-migrations-t/4571777 |
| Microsoft Learn: Create migration endpoints with OAuth authentication | https://learn.microsoft.com/en-us/exchange/hybrid-deployment/oauth-migration-endpoint |
| Microsoft Learn: New-MigrationEndpoint | https://learn.microsoft.com/en-us/powershell/module/exchangepowershell/new-migrationendpoint |
| Microsoft Learn: Load balancing in Exchange Server | https://learn.microsoft.com/en-us/exchange/architecture/client-access/load-balancing |
💬 Kommentare
0 KommentareSei der Erste und starte die Diskussion mit einem hilfreichen Beitrag.
Kommentar hinterlassen
Dein Beitrag wird vor der Veröffentlichung kurz geprüft — fachlich, respektvoll und auf den Punkt ist hier genau richtig.