Dedicated Cross-Tenant SharePoint Migration: Step-by-Step, Licensing, and Post-Move Remediation

Dedicated cross-tenant SharePoint migration is the workload-specific method for moving SharePoint sites between tenants using SharePoint Online PowerShell. Use it when you need to migrate shared sites (including Teams-connected SharePoint sites), which are out of scope for Orchestrator.

Scope and key constraints

·       Up to 4,000 SharePoint migrations can be scheduled at a time.

·       One-and-done: no incremental/delta passes; redirects are left behind.

·       Supported site types include group-connected sites (including those associated with Teams), modern non-group sites, classic sites, and communication sites.

·       This does not migrate Teams content, channels, or associated structure; for Teams-connected sites, only the SharePoint site content is migrated.

·       Do not precreate target SharePoint sites; if the site already exists, the migration fails (no overwrite/merge).

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

Licensing note (SharePoint shared data migration)

Microsoft describes Cross-Tenant Shared Data Migration licenses (for SharePoint) as currently available only to Enterprise Agreement customers, and offered per 100 GB of data moved. Confirm the latest licensing and purchasing model with your Microsoft account team.

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

# 1) Connect to the SharePoint admin endpoints
Connect-SPOService -Url https://<TenantName>-admin.sharepoint.com

# 2) Establish 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>

Then, after uploading the required identity mapping data and validating compatibility, start your moves, for example:

Start-SPOCrossTenantSiteContentMove -SourceSiteUrl <sourceSiteUrl> -TargetSiteUrl <targetSiteUrl> -TargetCrossTenantHostUrl <targetHostUrl>

Post-move remediation (plan this, do not improvise)

Microsoft calls out several categories that often require recreation or reconfiguration after SharePoint site migration: classic workflows (2010/2013), apps, Power Apps/Power Automate connections, web parts that reference other services, and sensitivity label behavior. Plan a remediation sprint and test the high-value business processes that depend on these components.

Source links (Microsoft Learn)

·       https://learn.microsoft.com/en-us/microsoft-365/enterprise/cross-tenant-sharepoint-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