A cloud-based service included in Microsoft 365, delivering scalable messaging and collaboration features with simplified management and automatic updates.
Hi @R Singh
Thanks for reaching out to the Microsoft Q&A forum.
Based on my research, I would like to offer some additional insights that may support the response already provided by Q&A Assist.
To begin, ensure that every user requiring migration has the Cross‑Tenant Migration Add‑On license. This step is essential to make sure the mailbox migration between tenants functions correctly.
The main stages of a cross‑tenant mailbox migration are as follows:
1/ Create a migration application in the target tenant
- Grant the app the
Mailbox.Migrationpermission under theOffice 365 Exchange OnlineAPIs. - Create a new client secret and keep the secret stored securely for later use.
2/ Grant consent to the application
- In the target destination, “Grant admin consent” for the app
- Create a URL that will be used in the source tenant to approve the application and enable mailbox migration.
Example: "https://login.microsoftonline.com/contoso.onmicrosoft.com/adminconsent?client_id=[application_id_of_the_app_you_just_created]&redirect_uri=https://office.com"
3/ Create a migration endpoint and an organization relationship to your destination tenant in the target tenant.
4/ From the source tenant, approve the migration application using the provided URL, and create a new organization relationship object that points to your target tenant.
5/ Prepare the target user accounts for migration
This includes syncing or setting values such as
- ExchangeGUID
- ArchiveGUID
- LegacyExchangeDN (as x500: proxyAddress)
- UserPrincipalName
- TargetAddress or ExternalEmailAddress
After that, assign the appropriate Exchange Online subscription.
6/ Verify the cross‑tenant migration configuration by running the Test‑MigrationServerAvailability cmdlet against the cross‑tenant migration endpoint that you created in the target tenant, as mentioned by Q&A Assist.
You can also use the Cross-tenant mailbox migration validation script, which helps identify inconsistencies across objects. This reduces the amount of time required during the initial preparation phase and ensures that the environment is ready for migration.
7/ Create and start migration batches
Use New‑MigrationBatch to begin the migration process once validation is complete.
For a full reference, you can review Microsoft’s official documentation: Cross-tenant mailbox migration - Microsoft 365 Enterprise | Microsoft Learn. It also includes helpful FAQs that explain many common questions during planning and execution.
I hope this provides additional insight. If you have any further questions or updates, please feel free to reach out.
Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.