Walkthrough - Copy teams

Copy teams and their channels so you can easily reorganize and restructure your teams in a way that makes sense for how people collaborate and move inside your organization.

Note: Copy teams comes with a few restrictions. We recommend that you read the Copy teams limitations article before you run a Teams migration.

Index

• Prerequisites
• How-to
  • Incremental copy

Prerequisites

• The Azure ShareGate Desktop application is consented on your tenant.
• You have global admin or SharePoint admin permissions.
  • If you do not have global admin permissions, you will also need Teams admin permissions in addition to your SharePoint admin permissions.
• You have a valid Teams license for the source and destination.
• You have logged into Teams at least once (in browser or in the Teams app) to have access to the hosted content.

Note: The prerequisites are applicable on your source and destination if you migrate teams to another tenant.

How-to

1. Select Copy from the menu.
2. Click Copy teams.
3. Select your source tenant in the left corner if it's already connected.
4. If your source tenant is not already connected, click No connections then +Add connection. For more information, see Connect to SharePoint and Microsoft 365.
5. Select a team to copy that team as a whole or to copy all of its channels to another team.
   
   Note: You can select multiple teams and channels to copy. You will be able to determine where you want to migrate everything at a later step.
   Tip: If you want to select specific channels only, click on the arrow symbol at the left of your team's icon to expand the list. For more information, see Walkthrough - Copy team channels.
6. Click 
7. Select your destination tenant if it's already connected.
8. If your destination tenant is not already connected, click +Add connection. For more information, see Connect to SharePoint and Microsoft 365.
9. Click  to map users.
10. Click the edit icon that appears when you hover your mouse on a team to rename the team or some of its channels in the destination.
11. To migrate a team and its channels as a new team at the destination, select Copy as a new team.
12. To migrate all the channels to a team at the destination, select Copy channels in an existing team.
    
    Note: When you select Copy channels in an existing team, you can search and select the destination team in the dropdown that appears.
13. Click  to migrate your Team(s).
14. Click  to migrate your Team(s) at a later time.
15. When you start the copy right away, you will be taken to the task summary page where you will be able to monitor the progress of the migration.
16. Once the action is completed, the migration report will show any successes, warnings, or errors. For more information, see Migration report.

Since you are creating new teams at the destination, team members will receive an email informing them that they are part of the new team. 

Incremental copy

You can use incremental copy for teams that were migrated with ShareGate Desktop 15.0 and higher. For more information, see Copy teams - Incremental.

If you remigrate a team that already exists in the destination, it will be duplicated.

Tip: If your initial migration was done with a version of the app prior to 15.0, or if you want more control over the incremental copy of your documents only, you can perform an incremental copy of the content in your teams' libraries using Copy content. To do so, select Copy content only in the copy screen, connect to the site collections attached to your source and destination teams, then select Copy if newer (Incremental) in your copy options.