Microsoft 365 tenant-to-tenant migration with ShareGate

01 Coul Sharegate Bt

Wondering how to transfer Microsoft 365 content after a merger or acquisition? We explain how ShareGate helps move SharePoint and OneDrive content in a Microsoft 365 tenant-to-tenant migration.

You did it! You made the move to Microsoft 365! You’re ready to settle down and stay awhile. Until one day, your boss knocks on your door and says the company is merging domains following a recent acquisition. Luckily, the other company’s intranet is also hosted in Microsoft 365. But what happens next?

The thought of a second migration might be daunting—but there’s no need for fear with ShareGate here! Our handy migration tool can also help you easily accomplish a tenant to tenant migration —something that’s especially useful in the context of a business merger or acquisition.

In this article, we walk you through the process step-by-step!


Preparing for your Microsoft 365 tenant-to-tenant migration

Like any other migration, the first thing you should do is prepare accordingly. Our ultimate Microsoft 365 migration checklist is an invaluable resource when it comes to avoiding costly mistakes and ensuring everything runs smoothly from start to finish.

Features in the Plan section of the ShareGate app can also help you stay on top of things:

  • Use the Source analysis report to get a complete understanding of your environment’s inventory and usage. Knowing exactly what you have—and where it’s located—will help you assess what should and shouldn’t be moved.
  • Our Permissions matrix report uncovers the access permissions your users and groups have for a given site—quickly telling you who has access to what and the various users who may be inside.
Sgm Public Source Analysis 1

You can also take advantage of these other built-in reports to help you plan your migration:

  • Site reportView crucial information (e.g. owner, size, date created, date last modified) about the sites in your source environment to help organize and streamline your migration plan.
  • Site collection reportAssess your environment with insights on your top-level site (e.g. site collection admin, size, date created, date last modified).
  • Checked-out documents reportFind all checked-out files and files with no checked-in versions, and check them in before copying them so no data is left behind.
  • Sites with custom permissions reportView all sites which do not inherit permissions from their parent.
  • Unused site reportGet a list of unused or abandoned sites that you may want to exclude from your migration, then download their content and delete them if necessary.
  • Documents with migration limitations report: Find all documents that will slow down your migration to Microsoft 365 by making it fall back to normal mode.
  • Workflow reportView all your list and site workflows.
  • Lists with workflows reportView all lists with workflows to avoid losing progress while a list is being copied.

Once you’re ready to begin setting up your migration, head to the Copy section of the ShareGate app:

Osg Public Migration 1

Select the type of migration you want to run and follow the prompts to connect to your source and destination environments…

Sgm Public Source And Destination 2 1

… then click on Run pre-check in the bottom right corner. Our pre-check report lets you simulate your migration before running it for real—so you can see and address potential issues without impacting your actual live environment.


What to expect during your Microsoft 365 tenant-to-tenant migration

You already know ShareGate can seamlessly handle a SharePoint to SharePoint migration. But what should you expect when it comes to other Microsoft 365 applications?

Learn SharePoint Online: Best practices, tips, and tricks.

OneDrive for Business to OneDrive for Business

ShareGate can also help move your users’ content from one OneDrive for Business to another.

To complete a OneDrive for Business migration:

  1. Create a CSV guide for your migration by following the step-by-step guide in our ShareGate support documentation.
  2. Copy and paste the following script in the PowerShell application of your choice:
Import-Module Sharegate
$csvFile = "C:\CSV\CopyContent.csv"
$table = Import-Csv $csvFile -Delimiter ","

$srcUsername = "sourceusername"
$srcPassword = ConvertTo-SecureString "sourcepassword" -AsPlainText -Force

$dstUsername = "destinationusername"
$dstPassword = ConvertTo-SecureString "destinationpassword" -AsPlainText -Force

Set-Variable srcSite, dstSite, srcList, dstList
foreach ($row in $table) {
    Clear-Variable $srcSite
    Clear-Variable $dstSite
    Clear-Variable $srcList
    Clear-Variable $dstList
    $srcSite = Connect-Site -Url $row.SourceSite -Username $srcUsername -Password $srcPassword
    Add-SiteCollectionAdministrator -Site $srcSite
    $dstSite = Connect-Site -Url $row.DestinationSite -Username $srcUsername -Password $srcPassword
    Add-SiteCollectionAdministrator -Site $dstSite
    $srcList = Get-List -Site $srcSite -Name "Documents"
    $dstList = Get-List -Site $dstSite -Name "Documents"
    Copy-Content -SourceList $srcList -DestinationList $dstList
    Remove-SiteCollectionAdministrator -Site $srcSite 
    Remove-SiteCollectionAdministrator -Site $dstSite 
}

Paste this script in whatever PowerShell application you prefer.
Source: ShareGate help: Migrating OneDrive for Business to OneDrive for Business with PowerShell

Note that:

Migrate Microsoft Teams from one tenant to another

01 Coul Sharegate Bt Nobg

Productivity tools like Microsoft Teams have become integral to how we work. 

That’s why, in the context of a business merger or acquisition, migrating this data over to the new location is no longer a nice-to-have. We need to be able to bring our existing Teams resources with us.

Luckily, it’s easy to migrate your Microsoft Teams to another tenant with ShareGate!

To copy teams and their channels as part of a Microsoft Teams migration:

  1. Click Copy in the menu at the left (the same screen you start at for a SharePoint migration), then select Copy teams.
  2. Decide whether you want to copy an entire team(s) with all the channels. Or, you can choose to only migrate specific channels.
  3. Follow the prompts to connect to your source and destination tenants. Then, select Copy as a new team next to a team to migrate that team and channels as a new team in the destination. Or, select Copy channels in an existing team to migrate your channels to a team in the destination.
Osg Public Migration 2

With our most recent ShareGate release, you can also migrate private channels!

Head to our support documentation for more details and a step-by step walkthrough of the Copy teams feature.

What about speed?

Cat

If you are moving from on prem to on prem, then speed will be a factor of your own environment’s making! But if you are moving from one Microsoft 365 environment to another, you are now on Microsoft’s turf and you may come across some issues with throttling.

Because Microsoft 365 continues to draw more and more customers and therefore more and more traffic, Microsoft needed to put mechanisms in place to ensure stability for all their customers – which is where the throttling comes into play.

Luckily, ShareGate also has mechanisms in place to avoid being throttled by Microsoft 365. Here are some tips to keep your migration running at optimal speed with ShareGate:

  • Provide consent to the Azure application in ShareGate. This consent will confirm for Azure that calls are coming from the known and trusted ShareGate app and alleviate any throttling.
  • Use ShareGate’s Insane Mode. Using the Insane Mode leverages Microsoft’s Import and Export API’s to bulk data and move it.
  • Migrate during off hours. This tried and true best practice is facilitated with ShareGate’s scheduling options.
  • Make sure your bandwidth is at its strongest. The operations are all done online, so having strong bandwidth is key.
  • Follow the tips in our curated guide. Download a copy of How to Optimize Your Migration Speed When Using ShareGate to learn how ShareGate interacts with the different components of your migration—as well as what bottlenecks to look out for that could negatively impact its speed.

When everything is finished, run a migration report to make sure everything was transferred over to your destination.

What did you think of this article?

Recommended by our team

Getting started is easy

Try ShareGate free for 15 days. No credit card required.

Gif Transparent

On-demand webinar Harmonize your SharePoint sites with Teams