Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article is Step 7 in a solution designed to complete a Cross-tenant OneDrive migration. To learn more, see Cross-tenant OneDrive migration overview.
- Step 1: Connect to the source and the target tenants
- Step 2: Establish trust between the source and the target tenant
- Step 3: Verify trust is established
- Step 4: Precreate users and groups
- Step 5: Prepare identity mapping
- Step 6: Start a Cross-tenant OneDrive migration
- Step 7: Post migration steps
Removing trust relationship
Important
Ensure you remove the Trust Relationship on both source and target tenants before your source tenant licenses expire. Once the licenses expire, the trust removal command doesn't work on the source.
On the source tenant, run this command to remove the trust relationship between Source and Target tenant.
Remove-SPOCrossTenantRelationship -Scenario MnA -PartnerRole Target -PartnerCrossTenantHostUrl <TARGETCrossTenantHostUrl>On the target tenant, run this command to remove the trust relationship between the target and source tenant.
Remove-SPOCrossTenantRelationship -Scenario MnA -PartnerRole Target -PartnerCrossTenantHostUrl <TARGETCrossTenantHostUrl>
Parameter definitions
| Parameter | Definition |
|---|---|
| PartnerRole | Roles of the partner tenant you're establishing trust with. Use source if partner tenant is the source of the OneDrive migrations, and target if the partner tenant is the destination. |
| PartnerCrossTenantHostURL | The cross-tenant host URL of the partner tenant. The partner tenant can determine this URL for you by running: Get-SPOCrossTenantHostURL on each of the tenants. |
Removing redirect links post migration
After you complete the migration from Source to Target, a redirect link is placed on the source. If users attempt to log back into their Source account or site, the link automatically redirects them to their new Target site. Remove the redirect links on the source after your full migration is complete.
Occasionally, a user may need to be migrated back to the original source. Remove the redirect link on the Target if you migrate a user back to the source.
- To remove redirect links, use the Remove-SPOSite PowerShell command.
- To get a list of all redirect sites on a tenant, use the Get-Sposite -Template RedirectSite#0 command.
Keep track of any user or site you migrate back to the source from the target. After successfully migrating these users or sites back to the source, confirm that the user and sites are accessible. Then you can remove the redirect link from Target using the Remove-SPOSite command.
Important
Site URLs must be unique. When migrating a user or site back to the source, the redirect site created on the initial move uses the original URL. This circumstance results in a conflict and causes the migration to fail if not removed.
Other post migration steps
Once the migration completes, OneDrive users must sign in using their new identity and resync their files to their devices on the target tenant.
OneDrive
With their new credentials, have users sign in to OneDrive using the Microsoft 365 app launcher or a web browser.
Permissions on OneDrive content
Users with permission to access OneDrive content continue to be able to access it, provided they were included in the identity mapping file.
OneDrive Sync Client
The user must sign in to the OneDrive Sync Client and their new OneDrive ___location using their new identity. Once you complete that step, the files and folders begin resyncing to the device.
Sharing Links
The existing shared links for the migrated files automatically redirect to the new target ___location.