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
Post a Comment