< All Topics

Microsoft Teams for Education Tenant to Tenant Migration Guide

Introduction

The Apps4.Pro Migration Manager guide offers a comprehensive, step-by-step approach to migrating Microsoft Teams Education, whether between tenants or within the same tenant.

This guide covers the entire migration process using Apps4.Pro for Microsoft 365 Education Teams, ensuring the secure transfer of class notebooks, grades, classwork, assignments, and class materials without data loss.

The following Education team types are supported in Apps4.Pro Migration Manager:

  • Class
  • Professional Learning Community (PLC)
  • Staff
  • Other

No Limitations

  • During Education 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 EDU Migration

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

What's Migrated?

Teams:

  • Public
  • Private

Channels:

  • Standard Channels
  • Private channels
  • Shared channels

Memberships:

  • Teams Users (Members and Owners)
  • 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
  • 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…)

Class Team:

  Team Creation:

  • Class Notebook

  Class work:

  • Create Module
  • Module Description & Formatting
  • Attach File
  • Assignment
  • Class Notebook – Existing Page, New Page – (Migrated as web link)
  • Link
  • Channel
  • Module name
  • Publish module
  • Pin/Unpin module

  Assignments:

  • Title
  • Description
  • Attachments
  • Excel, Link, Make Code, Teams File
  • Class Notebook
  • Searching Progress
  • New (Word, Excel, PowerPoint, Video)
  • Date & Time
  • Select modules
  • Points
  • Date & Time
  • Add Rubric
  • Tags
  • Add to Calendars
  • Post Notifications to

  Assign to Members:

  • Students only
  • All Current and Future Students
  • Individual tools

  Class Materials:

  • Class materials folder
  • Files
  • Permission

  Assignment Submissions (Students submissions):

  • Students submissions
  • To return
  • To returned
  • To return status
  • Returned Status
  • Points
  • Rubric points
  • Feedback

  Student Attachments:

  • OneDrive file
  • Link – (Link thumbnail not supported)
  • Teams file
  • Upload from local file
  • Word
  • Excel
  • PowerPoint
  • Class notebooks

  Submission Resource Feedback:

  • Files
  • Link
  • Word
  • PowerPoint
  • Video
What's not Migrated?

Channel:

  • Channel Connectors
  • Show/hide channel

Conversation:

  • Conversation reply settings

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

Class team:

  Team creation:

  • Home Page
  • Parent [Contacts / Announcement]

  Class Work:

  • Quiz

  Assignment:

  • Reading Progress
  • Existing Assignment – (Other Team)
  • Late Turn in Notification
  • Draft

  Assign to Members:

  • Group of Students

  New Quiz:

  • Title
  • Description
  • Date & time
  • Existing Quiz

Roles & Licenses for Teams EDU 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 EDU Teams that you choose to migrate
    • Owner of the EDU Teams with Private / Shared Channels.
    • Owner of the Assignments & OneNote

Architecture Diagram

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

Microsoft Teams EDU 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 EDU Migration

Before migrating Microsoft Teams for Education using Apps4.Pro Migration Manager, it is crucial to understand the migration requirements for both the source and destination endpoints. Ensure that all necessary prerequisites are met for a smooth and successful 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 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 EDU teams for migration.

Required Permissions for Target Connector :

PermissionJustification
Admin Consent [Delegated Permission]
Team.CreateUsed to create new Education 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 EDU 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 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.ReadWrite.AllUsed to update the OneNote notebook contents into the selected
Education 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 Education 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 M365 Education and OneNote 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
  • Source 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 Education 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 user mapping for Microsoft Education 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 EDU Teams) before moving all EDU Teams, to validate your setup and measure throughput.

Start Education 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 EDU 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 EDU 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
  • Assignments (Class Team Only)
  • Class Work

Add Source Connector to the selected Source Teams: This option helps to add the Source Connector as “Owner and Member” of the EDU 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 Education 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 Education 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 Education 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 Education 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 EDU 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 EDU 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
    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
    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.

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 EDU Teams & Conversations in the source tenant

Target:

Microsoft EDU Teams tab in the target tenant 

Team settings

Source:

Microsoft EDU Teams settings in the source tenant

Target:

Microsoft EDU Teams settings in the target tenant

Migration view of Private Channel

Source:

Microsoft EDU Teams private channel in the source tenant

Target:

Microsoft EDU Teams private channel in the target tenant 

Migration view of Shared Channel

Source:

Microsoft EDU Teams shared channel in the source tenant 

Target:

Microsoft EDU Teams shared channel in the target tenant

Class Notebook

Source:

Microsoft Education Teams Notebook in the source

Target:

Microsoft Education Teams Notebook in the target tenant

Assignments

Source:

Microsoft Education Teams Assignment in the source tenant   

Target:

Microsoft Education Teams Assignments in the target tenant

Considerations

We will migrate the @mention as regular text.

Microsoft EDU Teams conversation showing @mentions migrated as plain text from source to target tenant.

Announcement icon will not get migrated.

Comparison of an announcement message in Microsoft EDU Teams, with the icon missing in the target tenant after migration.

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

Microsoft Education 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 Education 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 Education 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 Education 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

Education 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 Education 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 Education Teams Conversations to ensure they are visible in Target Tenant and files are accessible.

Conclusion

In summary, Apps4.Pro Migration Manager enables an efficient and dependable transfer of Microsoft Teams data for education tenants within Office 365. By using this guide, administrators can preserve data accuracy, reduce interruptions in learning, and ensure consistent collaboration between educators and students. For further assistance, check out our FAQ section or reach out to our support team at support@jijitechnologies.com.

FAQs

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

The License and Roles required to perform Microsoft Education Teams migration between Office 365 tenants are listed 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 EDU Teams that you choose to migrate
    • Owner of the EDU Teams with Private / Shared Channels.
    • Owner of the Assignments & OneNote
What are the delegated Permissions required from the Source and Target Admins for Teams Education 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 EDU teams for migration.

Required Permissions for Target Connector:

Permission Justification
Admin Consent [Delegated Permission]
Team.Create Used to create new Education 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 EDU  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 Education teams for migration
How to migrate Microsoft Education Teams between Tenants?
  1. Configure the Source and Target Tenants.
  2. Configure M365 Education, OneNote API and SharePoint Connectors.
  3. Sync App data for Education Teams and users.
  4. Select the Education Teams you want to migrate.
  5. Initiate the migration process.
  6. Verify the accuracy of migrated data, including memberships, files, conversations and assignments.
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 Education Migration?

We can perform Incremental Migration with the Rerun function. It enables incremental migration for newly added items & conversations in the Source EDU Teams & Standard / Private / Shared 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.

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

The ‘Source Connector’ must be owner of all the Education 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 Education 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 Education Teams.
How to stop the email notifications popping out to users during the Microsoft Teams Education 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 Plan’s 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 Education Migration?

Before doing the 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 migration, now you can see your own customized content instead of the default context.

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.

How to customize the Teams mail nickname and Site alias during Microsoft Teams Education Migration?

During Task creation, you can customize the mail nickname and 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

What is the purpose of the ‘Advanced’ mode in Task creation in Microsoft Teams Education Migration?

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
What should I do if some Class Notebook sections are missing or inaccessible after migration?

In rare cases, Class Notebook content might take time to fully render in the destination due to sync delays. If sections appear missing or inaccessible, ensure OneNote sync is complete, and permissions are correctly applied. Contact support if issues persist after validation.

Does Apps4.Pro migrate Microsoft Teams associated SharePoint site files and other associated features during Teams Education 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 successfully migrated from one Microsoft 365 tenant to another. 

Does Apps4.Pro migrate the custom OneNote tabs in channel during Education Class Team migration?

Apps4.Pro does not migrate custom OneNote as tabs. This is because each custom OneNote is treated as a section within the default Class Notebook, which is migrated automatically as part of the Class Notebook migration. Therefore, the custom OneNote tabs are not recreated in the channel during Education Team migration.

However, the actual custom OneNote files are migrated from SharePoint and can be accessed from the corresponding folder within the associated channel sites.

Is it possible to migrate the Microsoft EDU 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 migration. 

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

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

Can we migrate more Microsoft Education Teams in parallel with this tool?

Yes, you can migrate multiple Microsoft Education 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 I migrate Class Teams from one EDU tenant to another, including all the content inside?

Yes, Apps4.Pro Migration Manager supports the migration of Microsoft Class Teams, including channels, files, posts (conversations), tabs, apps, and membership. However, some elements like Quiz are not supported due to Microsoft API limitations.

Can a channel from Source be migrated into an existing Education Team in Target?

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

  • Migrate as a new Education Team (OR)
  • [Recommended] Append all channels, conversations and files into an existing Education Team (OR)
  • Migrate to an existing Group & enable Teams for it – target Team’s name will be same as that of the group’s.
Will the Class Notebook, including student and teacher sections, remain intact after migration to the destination tenant?

Yes, the Class Notebook—along with individual student and teacher sections—will be migrated to the destination tenant.

Table of Contents
1