OneDrive migration step-by-step

OneDrive is not available for a user until their account has logged in at least once, or an admin pre-provisions it. Pre-provision all destination OneDrives before starting the migration.

• In SharePoint Admin Center → Settings → OneDrive, use PowerShell to pre-provision drives at scale.
• Command: Request-SPOPersonalSite -UserEmails @("[email protected]") for each user, or in bulk.
• Wait 10–15 minutes after provisioning before starting the migration job.

In TheMigrator → New migration, select OneDrive. Select source and destination tenants.

TheMigrator auto-maps drives by matching source and destination user UPNs. Review the mapping and fix any mismatches. Users with no destination match will be shown as unmatched.

Launch the job. OneDrive migration speed depends on file sizes — many small files migrate slower than fewer large files due to per-file API overhead.

• Expect 5–20 GB per hour per worker node under normal conditions.
• Files over 4 MB use the resumable upload API automatically — no special configuration needed.
• Files with names containing # or % may fail — these characters are not valid in SharePoint URLs.

Sharing links (anonymous links and specific-people links) are not carried over. Users will need to recreate any links they have shared externally. Notify users before cutover so they can record their important shared links.

After migration, users need to re-sign in to the OneDrive sync client with their destination account. The sync client will detect the new account and begin syncing from the destination. No manual folder reconfiguration is required if the destination UPN is set up correctly.