Dedicated Cross-Tenant OneDrive Migration: Step-by-Step and When to Use It

Dedicated cross-tenant OneDrive migration is the workload-specific method for moving personal OneDrive accounts between tenants using SharePoint Online PowerShell. It is especially useful when you want a OneDrive-only runbook, or when you are not using the orchestrated workload chain.

How it behaves (expectations to set)

·       Up to 4,000 OneDrive accounts can be scheduled at a time.

·       Migrations occur in the Microsoft 365 cloud with only a brief read-only window for the user.

·       A redirect is placed at the original OneDrive location so existing links keep working.

·       Cross-tenant moves are one-and-done: no incremental/delta passes.

·       Not supported for Government Cloud users (GCC, GCC High, DoD, etc.).

Prerequisites that frequently block projects

·       Licensing: verify you can purchase and assign cross-tenant user data migration licenses before proceeding; migrations fail if licensing is not in place.

·       Customer Key: if the source OneDrive tenant has Service encryption with Microsoft Purview Customer Key enabled, the migration fails.

·       Do not precreate target OneDrive sites: if a target OneDrive site already exists for a user, the migration fails (no overwrite).

·       Limits: 5 TB per OneDrive account and 1 million items per account. Path length limit is 400 characters.

·       Legal holds: OneDrive accounts with a hold are blocked; remove the hold, migrate, then reapply on the target.

Step-by-step: connect, establish trust, map identities, and start moves

# 1) Connect to both tenants
Connect-SPOService -Url https://<TenantName>-admin.sharepoint.com

# 2) Establish cross-tenant trust (run on both source and target)
Get-SPOCrossTenantHostUrl
Set-SPOCrossTenantRelationship -Scenario MnA -PartnerRole Target -PartnerCrossTenantHostUrl <TargetCrossTenantHostUrl>
Set-SPOCrossTenantRelationship -Scenario MnA -PartnerRole Source -PartnerCrossTenantHostUrl <SourceCrossTenantHostUrl>


# 3) Start the OneDrive move
Start-SPOCrossTenantUserContentMove -SourceUserPrincipalName <sourceUPN> -TargetUserPrincipalName <targetUPN> -TargetCrossTenantHostUrl <targetHostUrl>

Source links (Microsoft Learn)

·       https://learn.microsoft.com/en-us/microsoft-365/enterprise/cross-tenant-onedrive-migration?view=o365-worldwide

Comments

Popular posts from this blog

Skype for Business, Lync and Exchange Web Services (EWS) and different DNS Domains- Exchange crawling e.g. for presence

How to hide users from GAL if they are AD Connect synchronized

Exchange x500 address x500:/o=ExchangeLabs