< All Topics

Microsoft Teams Tenant to Tenant Migration Guide

Introduction

The Apps4.Pro Migration Manager guide provides a step-by-step process for migrating Microsoft Teams between tenants or within the same tenant using Apps4.Pro Migration Manager.

It covers the entire components of Teams, including teams, channels (standard, private, and shared), conversations, permissions, OneNote, tabs, and files. Additionally, the associated Teams SharePoint Online sites are automatically migrated.

Apps4.Pro Migration Manager also supports migrating Microsoft Education tenants. Please refer to the Microsoft Education Teams Migration Guide for more details.

No Limitations

  • During Teams Migration, there are no limitations on the number of teams, channels, conversations, permissions, OneNote files, and tabs that can be migrated. The process ensures a seamless transfer of all associated data without any restrictions.
  • Securely migrate files of any size without limitations.

Scope of Microsoft Teams Migration

The migrated and non-migrated items are listed below for Microsoft Teams Migration.

What's Migrated?

Teams

  • Public
  • Private

Channels

  • Standard Channels
  • Private channels
  • Shared channels

Memberships:

  • Teams Users (Members and Owners)
  • Membership (members, owners) with the use of a mapping table for address conversion
  • Shared Channel Membership – People Membership

Conversations

  • Conversation with inline image, GIF image, Praises, Approvals, Reactions (like smile) and Stickers
  • Includes code snippets, tables, text formatting, and attachments (images, files, videos).
  • Conversation with meetings
  • Conversation with important flag, @mentions, Announcement message and Pinned messages (Supported as TEXT & the icon will not be displayed)
  • Possibility to rename the teams
  • Batch migration and delta passes
  • Guest users & access- Need to map the equivalent guest user in target tenant
  • Channel Conversations (Individual Conversations or Html file)

Files:

  • Files tab -> folders, sub-folders and files
  • Files in channels are migrated with permissions (EXCLUDING metadata)
  • Possibility to migrate the private channel to existing standard channel or existing private channel

Tabs:

  • OneNote -> OneNote added from same Team
  • Planner
  • White Board
  • Word
  • Excel
  • PowerPoint
  • Website
  • PDF

Teams Settings:

  Member Permissions

  • Allow members to create and update channels
  • Allow members to create private channels
  • Allow members to delete and restore channels
  • Allow members to add and remove apps
  • Allow members to create, update, and remove tabs
  • Allow members to create, update, and remove connectors
  • Give members the option to delete their messages
  • Give members the option to edit their messages

  Guest Permissions

  • Allow guests to create and update channels
  • Allow guests to delete channels

  @ Mentions:

  • Show members the option to @team or @ [team name] (this will send a notification to everyone on the team)
  • Give members the option to @channel or @ [channel name]. This will notify everyone who’s shown the mentioned channel in their channel lists.

  Fun Stuff:

  • Enable Giphy for this team
  • Filter out inappropriate content using one of the settings below
  • Enable stickers and memes
  • Allow memes to be uploaded

  Specific Teams Settings:

  • Teams and their associated Office 365 group and group-specific settings.
  • Team specific settings (ex: Member Settings, Message Settings, Guest Settings, etc…)
  • Team settings (allowUserDeleteMessages, allowUserEditMessages, allowTeamMentions, etc…)
What's not Migrated?

Channel:

  • Channel Connectors
  • Show/hide channel

Conversation:

  • Conversation reply settings
  • Meeting Recordings- this can be migrated part of SharePoint Migration

Membership:

  • Shared Channel Membership – Team Membership

Files:

  • Empty folders

Tabs:

  • OneNote added from other team
  • Added OneNote which is created from OneNote app

Teams Settings:

  Member permission:

  Allow members to upload custom apps

  Fun Stuff:

  • Tags and their settings

  @ Mentions:

  • Team Code
  • Team Picture

  Teams and channel Settings:

  • Conversation reply settings
  • Private, Shared Channel specific settings
  • Channels Notification Settings
  • Pin/Unpin channel settings

The following items will not be migrated during Incremental Migration

Teams

  • Planner Tab
  • Changes done in an existing Task

Associated SharePoint

  • Components of Site Collections and Sites (Title, Navigation, Quick Lauch, Site Columns, Sub-sites…)
  • Site Permissions
  • Lists & their settings
  • Library Settings
  • Webparts
  • Workflows

Roles & Licenses for Teams Migration

  • Microsoft 365/Office 365 (E3 or E5) License is required for Source & Target Connector Accounts.
  • Microsoft Teams License is required for both Source & Target Connector accounts.
  • Teams Administrator role with Admin Consent and Delegated Permission is required for both Source & Target Connector accounts.
  • Source Connector Account should be a
    • Owner & Member of the Teams that you choose to migrate
    • Owner of the Teams with Private / Shared Channels.

Architecture Diagram

Apps4.Pro Microsoft Teams Migration architecture diagram showing data flow between Source and Target Tenants

Microsoft Teams Inventory Report

Follow the below steps to Export the Inventory Report of “Source Tenant – Team-wise Channel count” for better migration planning. 

Step 1 : Open Windows PowerShell ISE as Run as administrator

Step 2 : Download and open the attached script from PowerShell

Script File Link : GetTeamsChannelsCount.ps1

Step 3 : Replace the value of parameter “Path” to export the Teams Channel count details in the script.

Step 4 : Execute the script, and once it runs successfully, you will find the output CSV file saved in the location specified in the script.

Note : Ensure the script is executed using an account that holds either the “Team Admin” role or the “Global Admin” role for proper permissions.

Sample Output file :  TeamsChannelsCount.csv

Pre-Migration Setup for Teams Migration

Before migrating, Microsoft Teams using Apps4.Pro Migration Manager, it is essential to understand the migration requirements for both the source and destination endpoints. Ensure that all the following requirements are met for a smooth migration process.

Admin Consent & Delegate Permission

Apps4.Pro has its own Azure AD application, which gets registered during the application configuration.

Since migration uses service accounts with minimal privileges, Admin must provide Admin Consent & Delegate Permission just by clicking a link [Please contact us at presales@apps4.pro for the link]

Ask the admin to open the consent URL in their browser and sign-in with the admin account.

  • Click “Accept” to provide consent to use the Apps4.Pro app.

When the admins consent using the consent URL,

  • Application registered : “Apps4.Pro”, the required scopes are added with delegated permissions.
  • API involved :Microsoft Graph API

Required Permissions for Source Connector :

PermissionJustification
Admin Consent [Delegated Permission]
ChannelMessage.Read.AllUsed to retrieve the source team’s channel messages.
Group.Read.AllUsed to list all source group information from the source in AppData.
TeamSettings.Read.AllUsed to read both private and shared channel members from the selected team for migration.
ChannelSettings.Read.AllUsed to read the settings of the channels in the teams selected for migration.
TeamsTab.Read.AllUsed to read all channel tabs from each channel within the teams selected for migration.
ChannelMember.ReadWrite.AllUsed to read both private and shared channel members from the selected team for migration.
Offline_accessAllows the app to see and update the data you give it access to, even when users are not currently using the app. This does not give the app any additional permissions.
ProfileView users’ basic profile
OpenidAllows users to sign in to the app with their work or school accounts and allows the app to see basic user profile information.
User Consent
Notes.Read.AllUsed to retrieve OneNote notebooks for the selected teams for migration.

Required Permissions for Target Connector :

PermissionJustification
Admin Consent [Delegated Permission]
Team.CreateUsed to create new teams in the target environment.
TeamSettings.ReadWrite.AllUsed to  update the source team’s settings into the target team’s settings.
Channel.CreateUsed to create channels in the target team.
ChannelMember.ReadWrite.AllUsed to add members to the private and shared channels in the target environment.
ChannelSettings.ReadWrite.AllUsed to update the source team’s channel settings into the target team’s channel settings.
TeamsTab.ReadWrite.AllTo update the channel tabs in the target teams.
ChannelMessage.SendUsed to update the source team’s channel messages into the target team.
Files.ReadWrite.AllUsed to update the files in the corresponding location in the target.
offline_accessAllows the app to see and update the data you give it access to, even when users are not currently using the app. This does not give the app any additional permissions.
ProfileView user’s basic profile
OpenidAllows users to sign in to the app with their work or school accounts and allows the app to see basic user profile information.
User Consent
Notes.ReadWrite.AllUsed to update the OneNote notebook contents into the selected teams for migration

Note: Apps4.Pro supports MFA and Modern Authentication and hence there is no need to disable security features.

App Installation

Contact us at presales@apps4.pro to get the latest version of the Microsoft Teams Migration application download and installation process.

During the installation process, all necessary software required for the application (listed below) will be installed.

  • Node-v20.9.0-x64
  • Microsoft EdgeWebView2 Runtime
  • ASP.NET Core Runtime 6.0.20 x64
  • .NET Desktop Runtime 6.0.21 x64
  • Dotnet-sdk-3.1.426

Connect your Source & Target Environments

Source Connector Account – Sign-in

Establish a connection with the Source Connector Account by signing in through the Apps4.Pro Migration Manager app.

Steps to Connect:

  1. Go to the Setup tab in the Migration App.
  2. Under Source Connection, click on the Copy & Open button.
  3. Paste the copied code into the authentication window.
  4. Enter the Source Connector Account details to complete the connection.

Target Connector Account – Sign-in

Establish a connection with the Target Connector Account by signing in through the Apps4.Pro Migration Manager app.

Steps to Connect:

  1. Go to the Setup tab in the Migration App.
  2. Under Target Connection, click on the Copy & Open button.
  3. Paste the copied code into the authentication window.
  4. Enter the Target Connector Account details to complete the connection.

Configure Other Connectors

Configure the Source and Target Connectors for the below from the Setup tab :

  • Configure the Teams and Teams API connectors.
  • Configure the SharePoint connectors to migrate Associated SharePoint sites.

Application Tenant Data Refresh

Perform an Application Data Refresh before you start the Migration.

  1. Navigate to “Settings -> App Data”.
  2. Select the checkbox next to the below resources to perform a full sync of the app data resources for the following resources:
  • Source Tenant Users
  • Target Tenant Users
  • Source Tenant Teams
  • Target Tenant Teams
  • Source Tenant Groups
  • Target Tenant Groups
  • Source Tenant Plans
  • Target Tenant Plans
  • Source Tenant Sites
  • Target Tenant Sites

Note :

  1. Click on icon to download the source and target users, which can be used to frame the Tenant-level Users / Groups Mapping.
  2. If the checkbox is unselected, it performs an incremental refresh from the last time it was refreshed. You could also find the time when the data was previously refreshed here.

Configurations

User Mapping

The users in the source and target tenants need to be mapped so the app can intelligently utilize this information during migration.

Steps to Perform User Mapping:

Navigate to the “Mapping” tab → USERS MAPPING. Here, you can add user mappings based on any of the options listed below.

Option 1 – Individual Manual Mapping: Manually add user mappings using the “Add” option.

Option 2 – Bulk Mapping through Auto Map: If user’s display name or UPN in the source and target tenants are the same, our tool provides an “Automap” feature to streamline the mapping process.

Option 3 – Upload bulk mappings through CSV: If the display names of the users in the source and target tenants are different, you can download the sample file, add the user mappings, and import them using the “Import CSV” option.

You can download the tenant-level users to frame the Mapping CSV, please refer to Application Tenant Data Refresh.

Sample CSV File

Example CSV file showing user mapping for Microsoft Teams Migration between tenants.

Important: Using the “Clear All” option you can clear the previously added mappings in a single shot.

Group Mapping

The Office365 and Security groups in the Source and Target tenants need to be mapped, to get the group-level unique permissions of a SharePoint site to be migrated successfully.

Steps to Perform Group Mapping:

Navigate to the “Mapping” tab → GROUPS MAPPING. Here, you can add Group mappings based on any of the options listed below.

Option 1 – Individual Manual Mapping: Manually add Group mappings using the “Add” option.

Option 2 – Bulk Mapping through Auto Map: If Group’s display name or UPN in the source and target tenants are the same, our tool provides an “Automap” feature to streamline the mapping process.

Option 3 – Upload bulk mappings through CSV: If the display names of the Groups in the source and target tenants are different, you can download the sample file, add the Group mappings, and import them using the “Import CSV” option.

Sample CSV File

Example CSV file showing Group mapping for Microsoft Teams Migration between Tenants.

Important: Using the “Clear All” option you can clear the previously added mappings in a single shot.

Basic Task Settings for Associated Sites

As the associated SharePoint Task is created automatically, we have to configure the required ‘SharePoint-Basic Task Settings’ in advance for the SPO task to pick them.

  1. Navigate to Settings -> Other settings -> SharePoint Site Settings
  2. Click Set Button next to ‘Basic Task Settings’
  3. Select the required components from the below and Click Save.
    • Site Settings
    • Generic Lists
    • Document Library
    • Site Assets
    • All Files & Folders
    • OneNote
    • Subsites
    • Term Groups
    • Pages
    • Navigation
    • Regional Settings
    • External User Permission (applies to Site-level Permission only)

Migrate Version and Meta data

Apps4.Pro also migrates versions and metadata. You can choose to migrate all versions or only the latest ‘n’ versions based on your preference.

  1. Navigate to Settings -> Other settings -> SharePoint Site Settings.
  2. Enable the Option “Migrate File Version History”.
  3. Choose file version limit based on your preference.

Note:
1. RECOMMENDED: Opting for more versions slows down the migration process. So, the tool recommends unchecking this option, which migrates only the latest version of the File.

2. When opting for more versions, the tool recommends users to configure a maximum upto 200 versions.

Conversation Prefix [OPTIONAL]

The app will migrate the conversations appended with the conversation prefix. To change this prefix, Navigate to Settings -> Other settings -> Team Settings -> Conversation_Prefix.

The prefix will be appended before each conversation as below in the target tenant

Example of a Conversation Prefix displayed in a migrated Microsoft Team.

Skip Membership / Permission during Initial Migration [OPTIONAL]

When there are active users in Target Tenant, migrating the Team memberships & File permissions in the first place, gives the active users access to the migrated content during the migration.

This may affect the course of Migration. To avoid this, you can disable the below settings before the Initial Migration and then post completion of Initial Migration, enable these settings and re-trigger migration.

  1. Settings tab –> Other settings –> Team settings -> “Teams – Migrate Membership”
  2. Settings tab –> Other settings –> SharePoint Site settings -> “Migrate Permissions”

Once all the above preparatory steps are done, you are ready to create a Migration Task.

Recommended: We recommend running a small Pilot Migration (perhaps one or two Teams) before moving all Teams, to validate your setup and measure throughput.

Start Teams Migration

Create Task

Follow the below steps to create a task

  1. Navigate to ‘Teams’ tab.
  2. Hit ‘Refresh’ to load the Teams.
  3. Select the Teams you want to migrate.

Migration from CSV: Select a bulk number of Teams in a single shot using this option.

You can Browse for a CSV containing the details of the Teams to be Migrated.

Sample CSV :

You can always download a sample CSV from our tool to feed in your data by clicking the button Sample CSV.

Example of a CSV format used as input for Microsoft Teams Migration.

Migration Settings

You can also choose the components to be part of the Microsoft Teams Migration that includes

  • Channels (Standard Channels)
  • Conversations
  • Files
  • Private Channels
  • Shared Channels
  • OneNote tab
  • Planner tab
  • Office tab
  • Website tab

Add Source Connector to the selected Source Teams: This option helps to add the Source Connector as “Owner and Member” of the teams to be migrated, if they have not been added previously.

Task Creation Mode

Basic Mode

Choose ‘Basic’ Mode to enable Teams to have the exact replica of the Source to the Target with no tailoring needed in Target teams, channels, tabs and plans in scope. In this case, the tool migrates entire Teams in Basic Mode. If you prefer to customize the migration process, you can use Advanced Mode.

Advanced Mode

Choose ‘Advanced’ Mode to tailor the teams, channels, tabs and plans in scope.

This helps to make customizations in the target

  • As a new / existing team, channel, tab or plan.
  • Customize the names of the target team, channel, tab or plan.
  • Choose how to migrate the conversations
Team Settings

In this step, you can choose how do you want the target team(s) to be. You will have the following three options to decide on.

  • Migrate into a new Team (OR)
  • Append all team data into an existing Team (OR)
  • Enable the team for an existing Group – target team’s name will be same as Target Group.

Migrate User : When migrating to an existing team / group, one can choose to migrate the additional members by enabling this option.

Channel Settings

Under Channel Settings tab, you can choose required channels to migrate and required components to be migrated along with channels. For existing target team, you can choose to migrate channel details either to a New Channel or an already Existing Channel(target).

You can even migrate conversations starting from a particular date by specifying a date in Column Conversation -> Migration From.

Tab Settings

Under Tab Settings, you can choose required tabs to migrate and map the tab with existing tab if you have selected existing target team/channel.

Plan Settings

Under Plan Settings tab, it lists the plans available in the selected teams.

Planner Task Attachments : You can select the target format from one of the below:

  • None – no attachments will be migrated
  • Copy URLs and SharePoint Files
  • Copy URLs alone

Post configuring all the above attributes, click Migrate. This creates one task for each of the Teams selected.

Task Execution

You can track the progress and migration status in the TASKS section.

  • Task in Queue:
    After task creation, it enters the Queue section, awaiting processing.
  • Task in InProgress: 
    The task then moves to In Progress, where migration begins. During this stage, all teams, channels, conversations, tabs and files are transferred from the Source to the Target.
  • Task in Pause: 
    The task can be paused if needed, temporarily halting the migration process.
  • Task completed: 
    Once the migration is successfully completed, the task moves to the Completed section.

View Details : You can check the detailed status of each action (like Migrate Team, Migrate Member, Migrate Channel) at channel or conversation level.

Migration of Associated SharePoint Sites

Once the Teams Migration tasks complete, associated SPO tasks are created automatically which can be tracked under SharePoint tab -> TASKS.

Part of the SPO task, associated SharePoint Sites of the Groups linked with the selected Teams are migrated. Based on the “Basic Task Settings”, configured components are migrated.

Important: OneNote content and the channel files are migrated part of the Associated SharePoint Task only.

How to resolve errors using ‘Retry’ Option ?

The Retry function helps resolve errors when a task is completed with an error or warning.

Steps to Perform Retry:

  1. Navigate to Teams → Tasks → Completed tab.
  2. Identify the tasks with a status of “Completed with Errors” or “Completed with Warning”
  3. Select the task you want to retry.
  4. Click ‘Retry’ to resolve the error / warning.

How to perform Incremental Migration ?

The Rerun function enables incremental migration for newly added items & conversations in the Source Teams & Channels after the initial migration.

Steps to Perform Incremental Migration:

  1. Navigate to Teams TASKSCOMPLETED Tab.
  2. Select the Tasks that require Incremental Migration.
  3. Click ‘Rerun’ to initiate the Incremental Migration.

Note: If the task status is “Completed with Errors” or “Completed with Warning” review the errors/warnings with the support team before proceeding with the Incremental Migration.

Get Summary view of the Migration Tasks

1.Navigate to Teams -> Summary

2. Click Sync to load the latest Task Summary

3. All Tasks Results : Lists down all the tasks including the ones Completed with Errors & Warnings. You can also Retry the tasks that are Completed with Errors / Warnings from here.

Here, you get the

  1. Overall Task-wise Success / Failed count on
    • Channels
    • Tabs
    • Conversations
  2. For the Associated SharePoint Sites, Overall Task-wise Success / Failed count on
    • Document Library
    • Files
    • Lists
    • List Items
  3. Specific error / warning wise count.
  4. All Tasks Errors : Lists down all the tasks that were Completed with Errors. Here, you get the detailed error message Item-wise.
  5. All Tasks Warnings : Lists down all the tasks that were Completed with Warnings. Here, you get the detailed warning message Item-wise.

    Note:

    You cannot resolve SharePoint Related errors by Retrying the Teams Tasks here. It must be resolved by Retrying the Associated SharePoint Tasks from

    • SharePoint tab ->Summary -> All Tasks Results [OR]
    • SharePoint tab ->Tasks -> Completed

    Email Notification

    When migrated to a NEW Target Team

    End users will get below notifications in Microsoft Teams Activity Feed, when migrating the team’s data to a New Team in target tenant.

    • Added You to the team
    • Added You to the private channel
    • Added You to the Shared channel
    Notification message displayed when a user is added to a channel in the Target Team during Migration.

    Note: We cannot avoid these notifications.

    When migrated to an Existing Planner Tab in Target

    End users will get notifications when migrating the below stated items to a pre-existing planner tab in Target.

    • Comments
    • Task Assignments

    To avoid these notifications, each end user needs to enable the below settings.

    1. Outlook: Group Mailbox Settings
      In Outlook, Open the Mailbox of Respective Plan’s Office 365 group which we are going to migrate. Click on Settings icon & Select Don’t receive any group messages.
    2. Planner Settings
      Go to Planner -> Click Settings Icon  on top right corner -> Click Notifications -> Turn Off the below settings under Planner notifications and click Save.
    • Email me when someone assigns me a task
    • Email me when a task assigned to me is late, due today, or due within the next seven days

    Note: However, we can’t avoid these notifications during the plan migration to a “New Team”.

    Post Migration

    End-user Experience

    Team & Conversations

    Source:

    Microsoft Teams tab in the Source Tenant

    Target:

    Microsoft Teams tab in the Target Tenant

    Teams Settings

    Source:

    Microsoft Teams settings in the Source Tenant

    Target:

    Microsoft Teams settings in the Target Tenant

    Private Channel

    Source:

    Microsoft Teams private channel in the Source Tenant

    Target:

    Microsoft Teams private channel in the Target Tenant

    Shared Channel

    Source:

    Microsoft Teams shared channel in the Source Tenant

    Target:

    Microsoft Teams shared channel in the Target Tenant

    Considerations

    We will migrate the @mention as regular text.

    Microsoft Teams conversation showing @mentions migrated as text from Source to Target Tenant.

    Announcement icon will not get migrated.

    Comparison of an announcement message in Microsoft Teams, with the icon missing in the Target Tenant after migration.

    Code snippet: We will migrate the code snippet as attachment.

    Microsoft Teams conversation showing code snippet migrated as attachment from Source to Target Tenant.

    Post Migration Activities

    Note:
    1. Once the migration tasks are completed, the ‘Source Connector’ and ‘Target Connector’ can be removed from all the migrated teams at once.

    2. Before you remove them, ensure if all the Tasks created for Migration and Incremental Sync are completed successfully.

    How to Remove ‘Source Connector Account’ from the Migrated Microsoft Teams

    Part of the Migration Process, ‘Source Connector’ is added as Owner of all the migrated Source Teams, and hence it must be removed post Migration. To achieve this in a single shot, we can remove it by following the steps below.

    1. Navigate to Plan tab -> Reports -> All Source Teams.
    2. Generate the ‘All Source Teams’ report.
    3. Select All Teams by clicking the checkbox in the 1st Column Header.
    4. On clicking “Manage Members and Owners”, a pop-up appears.
      • Choose ‘Remove Owner’ in Action.
      • Click + icon and Choose the ’Source Connector’ & Update.
    5. Action Results are shown if the ‘Source Connector’ is removed from the selected teams.

    How to Remove ‘Target Connector Account’ from the Migrated Teams

    Part of the Migration Process, ‘Target Connector’ is added as Owner of all the migrated Target Teams, and hence it must be removed post Migration. To achieve this in a single shot, we can remove it by following the steps below.

    1. Navigating to Plan -> Reports -> All Target Teams.
    2. Generate the ‘All Target Teams’ report.
    3. Select All Teams by clicking the checkbox in the 1st Column Header.
    4. On clicking “Manage Members and Owners”, a pop-up appears.
      • Choose ‘Remove Owner’ in Action.
      • Click + icon and Choose the ’Target Connector’ & Update.
    5. Action Results are shown if the ‘Target Connector’ is removed from the selected teams.

    Troubleshoot

    If you require support or guidance on the errors, warnings or non-migrated items, get the logs and mail them to support@jijitechnologies.com for further analysis.

    To get the logs, go to the Teams tab -> TASKS -> COMPLETED -> Export Logs.

    Reports

    Teams Migration Summary Report

    The “Teams Migration Summary” report provides a comprehensive overview of the Apps4.Pro migration, detailing the total number of channels, conversations, files and tabs in the source Teams, along with the Apps4.Pro migrated counts for each item. This report helps in verifying the completeness of the migration process and ensures data consistency between the source and destination environments.

    Steps to Generate the “Teams Migration Summary” Report:

    1. Go to Plans → Reports → Migrated Summary V2 section.
    2. Select the “Teams Migration Summary” report.
    3. Click the “Generate” button to populate the values.

    Important: Verify the migration of a few random Team’s Conversations to ensure they are visible in Target Tenant and files are accessible.

    Conclusion

     Using Apps4.Pro Migration Manager for Teams ensures a seamless and efficient transfer of your Teams data, including conversation, files, and memberships. By following the outlined steps, you can confidently migrate Teams content between Office 365 Tenants. For further assistance or inquiries, refer to our FAQ or reach out to our support Team at support@jijitechnologies.com.

    FAQs

    What are the minimal licenses, roles & permissions required to perform Microsoft Teams Migration?

    The license and roles required to perform Microsoft Teams to Microsoft Teams Migration are as below :

      • Microsoft 365/Office 365(E3 or E5) License is required for Source & Target Connector Accounts.

      • Microsoft Teams License is required for both Source & Target Connector accounts.

      • Teams Administrator role with Admin Consent and Delegated Permission is required for both Source & Target Connector accounts.

      • Source Connector Account should be a
          • Owner & Member of the Teams that you choose to migrate

          • Owner of the Teams with Private / Shared Channels.

    What are the delegated Permissions required from the Source and Target Admins for Microsoft Teams Migration?

    Required Permissions for Source Connector :

    Permission Justification
    Admin Consent [Delegated Permission]
    ChannelMessage.Read.All Used to retrieve the source team’s channel messages.
    Group.Read.All Used to list all source group information from the source in AppData.
    TeamSettings.Read.All Used to read both private and shared channel members from the selected team for migration.
    ChannelSettings.Read.All Used to read the settings of the channels in the teams selected for migration.
    TeamsTab.Read.All Used to read all channel tabs from each channel within the teams selected for migration.
    ChannelMember.ReadWrite.All Used to read both private and shared channel members from the selected team for migration.
    Offline_access Allows the app to see and update the data you give it access to, even when users are not currently using the app. This does not give the app any additional permissions.
    Profile View users’ basic profile
    Openid Allows users to sign in to the app with their work or school accounts and allows the app to see basic user profile information.
    User Consent
    Notes.Read.All Used to retrieve OneNote notebooks for the selected teams for migration.

    Required Permissions for Target Connector :

    Permission Justification
    Admin Consent [Delegated Permission]
    Team.Create Used to create new teams in the target environment.
    TeamSettings.ReadWrite.All Used to update the source team’s settings into the target team’s settings.
    Channel.Create Used to create channels in the target team.
    ChannelMember.ReadWrite.All Used to add members to the private and shared channels in the target environment.
    ChannelSettings.ReadWrite.All Used to update the source team’s channel settings into the target team’s channel settings.
    TeamsTab.ReadWrite.All To update the channel tabs in the target teams.
    ChannelMessage.Send Used to update the source team’s channel messages into the target team.
    Files.ReadWrite.All Used to update the files in the corresponding location in the target.
    offline_access Allows the app to see and update the data you give it access to, even when users are not currently using the app. This does not give the app any additional permissions.
    Profile View users’ basic profile
    Openid Allows users to sign in to the app with their work or school accounts and allows the app to see basic user profile information.
    User Consent
    Notes.ReadWrite.All Used to update the OneNote notebook contents into the selected teams for migration
    How to migrate Microsoft Teams from one tenant to another?
    1. Configure the Source and Target Tenants.
    2. Configure Teams, Teams API and SharePoint Connectors.
    3. Sync App data for Teams, Users and Sites.
    4. Select the Teams you want to migrate.
    5. Initiate the migration process.
    6. Verify the accuracy of migrated data, including memberships, files, and conversations.
    How to get the Teams Inventory Report at Tenant level?

    Follow the below steps to Export the Inventory Report of “Source Tenant – Team-wise Channel count” for better migration planning for Microsoft Teams Education Tenant migration from one tenant to another.

    Step 1 : Open Windows PowerShell ISE as Run as administrator

    Step 2 : Download and open the attached script from PowerShell

    Script File Link: GetTeamsChannelsCount.ps1

    Step 3 : Replace the value of parameter “Path” to export the Teams Channel count details in the script.

    Step 4 : Execute the script, and once it runs successfully, you will find the output CSV file saved in the location specified in the script.

    Note :Ensure the script is executed using an account that holds either the “Team Admin” role or the “Global Admin” role for proper permissions.

    Sample Output file:  TeamsChannelsCount.csv

    How do we perform Incremental Migration for Microsoft Teams Migration between tenants?

    We can perform Incremental Migration with the Rerun function. It enables incremental migration for newly added items & conversations in the Source Teams & Standard / Private / shared Channels after the initial migration.

    Steps to Perform Incremental Migration:

    1. Navigate to TeamsTASKSCOMPLETED Tab.
    2. Select the Tasks that require Incremental Migration.
    3. Click ‘Rerun’ to initiate the Incremental Migration.

    Note: If the task status is “Completed with Errors” or “Completed with Warning” review the errors/warnings with the support team before proceeding with the Incremental Migration.

    How to add ‘Source Connector Account’ as a Owner of the Teams through the Apps4.Pro Migration Manager tool?

    The ‘Source Connector’ must be owner of all the Teams that has to be migrated. “User Administrator” access is recommended for the same.

    To achieve this in a single shot, follow the below steps.

    1. Navigate to Plan -> Reports.
    2. Under Teams, open the report “All Source Teams”.
    3. Generate the report
    4. Select All Teams by clicking the checkbox in the header.
    5. On clicking “Manage Members and Owners”, a pop-up appears.
      a.  Choose ‘Add Owner’ in Action.
      b.  Click + icon and Choose the ’Source Connector’ & Update.
    6. Action Results are shown if the ‘Source Connector’ is added to the selected Teams.
    How to stop the email notifications popping out to users during the Microsoft Teams Migration for the Planner task comments and assignments?

    When migrated to an Existing Plan in Target, end users will get Email notifications when migrating the below stated items.

    • Comments
    • Task Assignments

    To avoid these notifications, each end user needs to enable the below settings.

    1. Microsoft Outlook: Group Mailbox Settings
      In Outlook, Open the Mailbox of Respective Plans’ Office 365 group which we are going to migrate. Click on Settings icon  & Select Don’t receive any group messages.
    2. Microsoft Planner Settings: Go to Planner -> Click Settings Icon  on top right corner -> Click Notifications -> Turn Off the below settings under Planner notifications and click Save.
      • Email me when someone assigns me a task
      • Email me when a task assigned to me is late, due today, or due within the next seven days

    Note: However, we can’t avoid these notifications when migrated to a “New Plan”.

    How can I remove or edit the “Conversation migrated from other tenant” default content in migrated conversation, during Microsoft Teams Migration?

    Before doing the Teams tenant to tenant migration, please go to Settings Tab –> click on Other Settings –> Migration Settings -> Team Settings –> Edit or Remove the content in Conversation_Prefix option and Save the settings.

    Then proceed with the Teams migration, now you can see your own customized content instead of the default context.

    In Microsoft Teams Migration, what is the purpose of the ‘Advanced’ mode in Task creation?

    The ‘Advanced’ mode enables the below feasibilities for the user.

    • To perform target tenant scan – map to an existing Team in target
    • To migrate only specific channels
    • To customize the Team name in target
    • To perform Teams consolidation in the target
    Does Apps4.Pro migrate Microsoft Teams associated SharePoint site files and other associated features during Teams Migration?

    Yes, Apps4.Pro migrates Teams channel files along with other files associated with the underlying SharePoint site. Once a Teams migration task is executed, the tool automatically generates and executes the corresponding SharePoint migration task in the backend, ensuring that the Team’s associated site content is migrated from the source tenant to the target tenant seamlessly.

    During Microsoft Teams Migration, how to customize the Teams mail nickname or Site alias?

    During Task creation, you can customize the mail nickname or Site alias in the below ways

      1. When you create Task with Advanced mode, you can find the settings to customize the mail nickname in the Team Settings.
      2. You can also feed-in the new Mail Nicknames in the CSV uploaded for migrating the Teams.

    Customize mailnickname and sitealias

     

    Is it possible to migrate the Team conversations from a specific date?

    Yes, it’s possible. When creating a migration task in Advanced Mode, you can set the “Migrate From” date under Channel Settings. Simply specify the date from which you want to start migrating conversations, and then proceed with the Team’s migration.

    Is it possible to migrate the particular channels alone in the Microsoft Teams Migration?

    You can select the specific Teams channels you wish to migrate under Channel Settings. To skip certain channels from migration, simply deselect them from the list.

    How long it takes for a Guest user to appear in MS Teams? When can Guest users access the Team in destination tenant after the Team creation?

    If you have already enabled the Microsoft Teams Guest access in the destination tenant and already added the guest user member, then the guest user can immediately access the destination team once the migration is completed.

    Can we migrate more Teams in parallel with this tool?

    Yes, you can migrate multiple teams in parallel with this tool.

    To perform this,

    1. Navigate to Teams tab -> Source.
    2. Select the teams that has to be migrated and click ‘Migrate’.

    Each team is treated as a separate task. Once a team task is completed, its associated SharePoint task will be created under the SharePoint > TASKS tab and will start automatically. By default, up to three tasks will run in parallel based on the default scheduler configuration.

    Can a channel from source be migrated into an existing Teams in target in the target tenant?

    Yes, you can do that. When configuring the target Team settings, you have the following options to choose from

    •  Migrate as a new Team (OR)
    •   Append all channels, conversations and files into an existing Team (OR)
    • Migrate to an existing Group & enable Teams for it – target Team’s name will be same as that of the group’s.
    Table of Contents
    1