Microsoft Teams Migration FAQs

This guide will cover frequently asked questions and troubleshooting processes related to Microsoft Teams to Microsoft Teams migrations. It is not intended to replace any part of the migration guide, which lays out the steps necessary to perform a Teams to Teams migration. 

A note about private channels

Due to Microsoft limitations, private channels are not migrated for GCC High Tenants.

Migrating guests

Guest access on the source will be migrated if the guest exists and guest permissions are enabled at the destination tenant prior to migration. This may be done via the Teams or Office 365 admin portal.

Other Limitations

1. Conversations

A Conversation History tab will be created for each corresponding channel at the destination. Each team will show the most recent 60 conversation threads (60 root messages + all replies), while all older message threads may be downloaded as an HTML file in the Conversation History tab.

This number may be increased through the use of the advanced option:TeamsMaxConversationPostPerTeam=XXXX. Replace XXXX with the number of message threads you wish to migrate. E.g.

TeamsMaxConversationPostPerTeam=1000 would load 1000 conversation posts per team. This total is split between channels that are in each Team e.g. If there are 10 channels in a Team then you would see 100 conversation posts migrated per channel. This may slow your migration, so plan accordingly if you use this option. 

2. Teams for Education Migration 

MigrationWiz can assist with the migration of Microsoft Teams for Education (Classroom template only, including Classroom Notebook). We currently do not support the migration of Notebooks for Teams based on PLC or Staff templates.
Note: Teams based on these templates will need to be provisioned in the destination prior to migration. Please contact Sales for more information.

3. GoDaddy 

Due to limitations on connections allowed by GoDaddy, we do not support migrating to or from GoDaddy using this migration type.

Permissions

How long does the Azure SAS token last for the Microsoft-provided Azure Storage?

The Azure storage SAS token Microsoft provides to us last only 5 days instead of 30 days.

Adding app permissions

  1. Ensure you are signed in as a Global Admin in the Office 365 Admin Portal.

  2. Go to MigrationWiz-Teams-FullControl and consent to the app access when prompted. 

  3. Create new Security Group named “MigrationWiz” on the Office 365 Admin Portal. If you have not created a security group before, follow Microsoft's instructions.

  4. Create new user. This user must have an active Teams license applied.

  5. Add new user to previously created security group as a member. Important: ADFS and MFA must be turned off for this user.

  6. Create MigrationWiz project.

  7. When creating the endpoints, enter the new user credentials.

Steps to enable permission level at the destination:

  1. Ensure you are signed in as a Global Admin.

  2. Go to MigrationWiz-Teams-FullControl and consent to the app access when prompted.

  3. Create new Security Group named “MigrationWiz” on the Office 365 Admin Portal.

  4. Create new user. Important: ADFS and MFA must be turned off for this user.

  5. Add new user to previously created security group as a member.

  6. Create MigrationWiz project.

  7. When creating the endpoints, enter the new user credentials.

MigrationWiz-Teams-FullControl may be used on both source and destination tenant and will export document permissions. 

Post-Migration Steps

  1. Remove the newly created user.

  2. Remove the MigrationWiz Security Group created in Step 3.

  3. To remove the app from the source or destination, perform the following steps:

    1. Launch PowerShell.

    2. Connect PowerShell to Office 365.

    3. Enter the command: Connect-AzureAD

    4. Enter the admin credentials in the prompt.

    5. Enter the command:Get-AzureADServicePrincipal -SearchString Migration

    6. Look for the ObjectId of the app you want to remove and enter the following command: Remove-AzureADServicePrincipal -objectId <the object id>

Adding Teams & Autodiscovery

What is the difference between the previous Assessment and Autodiscovery?

Assessment previously would calculate the number of teams, number of users file size and licenses needed.

Autodiscover will only discover the total number of teams at the Source

As such, from a speed perspective, autodiscover should be relatively faster than the Assessment. Once auto-discover has completed, users can import the teams and all the teams will be populated as line items.

What should I do when auto-discovery fails?

Check your Source credentials. Auto-discover will fail if the credentials verification fails.

What will Folder Summary show?

Folder summary will be shown per team level, so all the channels, documents and document permissions specific only to that team.

Migrating Teams

Can I select which Teams to migrate?

Yes, by checking only those teams to be migrated after the adding of teams is done either via auto-disover, quick add or bulk add.

Can I migrate only specific users?

No. All users in a selected team will be migrated.

How do I apply user mapping for large number of users?

  1. Download and install BitTitan SDK (this link will take you to instructions and a download option).

  2. Download the script and example file attached at the end of this article (Add-MWTeamsUserMapping.ps1 and example.com).

  3. Fill in the example.csv with the desired user mapping

  4. Retrieve your Teams project ID. This can be obtained by copying the text after the projects/ and before the ?, as shown below.Teams_User_ID.png

  5. Run Powershell as an Adminstrator.

  6. Run this command:

    Set-ExecutionPolicy Unrestricted -Scope CurrentUser
    cd <Download folder>
    .\Add-MWTeamsUserMapping.ps1 -projectId <Teams project id> -csv <your csv path>
  7. E.g: .\Add-MWTeamsUserMapping.ps1 -projectId b2b00b67-c6fc-11ea-a81a-000d3af5b517 -csv .\example.csv

  8. Enter your MigrationWiz Account username and password.

  9. Input the path to the CSV file with the user mapping.

Can I rename a team before migration?

Yes. However, only the MailNickname gets renamed. There will not be any changes to the Display Name. Prepend/AppendFolder AdvancedOptions is no longer supported for the Teams connector.

Can I migrate a Team to an existing Microsoft 365 group that is NOT Teams enabled at the destination?

Yes, you can migrate a source Team to an existing Microsoft 365 group in the target tenant even if it is not a Teams-enabled group. We will enable it for you in the "Teams Creation" pass. We then proceed to migrate the source data as expected behavior in a Teams migration.

Are Teams permission migrated?

Yes. We recommend migrating the permissions last to ensure owners and members at the destination do not get e-mail alerts to access incomplete Teams.

If a team at the destination exists with the same name as a team at the Source tenant, can I rename the specific Team before the migration?

Yes. Click on the Edit icon of the team/line item and change the Destination MailNickname.

Can I migrate Teams with special characters in the name?

Yes. The steps for this are included in the Teams to Teams Migration Guide.

Can I migrate archived Teams?

Currently, archived teams are migrated over as a non-archived team. Private channels of archived teams will not be migrated. Channel tabs from archived teams will not be migrated. This is a known Microsoft API limitation.

SharePoint sites are live in the destination. Will the Teams automatically connect to the SharePoint sites after Teams have been migrated? 

No, because this is dependent on Microsoft Teams, we don’t have control. Once a team is created, a new SharePoint site will be created for that team.

Migrating Private Channels

Can I migrate private channels belonging to an archived team?

No. This is still a Microsoft API limitation.

Can I skip private channel migration?

Yes, add the Advanced Option TeamsSkipPrivateChannel=1 into the project before starting the migration

Are there any prerequisites that I must take care of on my destination Tenant before migration?

Please ensure that destination tenant does not restrict creation of private channels.

Migrating Tabs & OneNote Documents

MigrationWiz supports the migration of tabs including OneNote, Word, Excel, PowerPoint, PDF, and websites as part of the Teams to Teams migration process. There will be a new optional item type, Channel Tabs, in the Start Migration flyout. The steps for this migration option are found in the Teams to Teams migration guide. 

However, Channel Tabs can only be migrated after the initial migration of documents and the OneNote instance. We also recommend waiting at least four hours after the initial document & OneNote migration has completed before starting the Channel Tabs migration.

Tabs1.png

Can I see which tabs have been migrated? 

Yes. Migrated tabs will be reflected in the ‘Folder Summary’ section of the respective team/channel. The Migrated Items section will also show the total number of tabs migrated.

How do I migrate tabs? 

The steps for this process are found in the Teams to Teams migration guide.

Can I select specific tabs to migrate before starting the migration?

No.

For new projects (started after October 6, 2021) once the Channel Tabs item type is selected, MigrationWiz will migrate OneNote, Microsoft Word, Excel, PowerPoint, PDF, and Websites tabs by default.

However, for existing projects created before October 6, 2021, only OneNote tabs will be migrated by default.

TeamsMigrateChannelTabs=1 Advanced Options can be added to migrate Microsoft Word, Excel, PowerPoint, PDF and Websites tabs in addition to OneNote tabs.

What does the warning message ‘Skipping Tab: TabName for the Channel...‘ mean?

Since the files do not belong to its root or its own Private channel document library, MigrationWiz is not able to remap it. This is a known limitation. Recommended workaround is to manually create it at the destination.

What are the OneNote migration limitations?

The following OneNote items are not migrated.  

  • A OneNote document present in an individual user’s OneDrive account
    (This will be migrated via the standard MigrationWiz document project. A warning message will be shown).

  • Personal OneNote instances and non-Teams OneNote instances will not be migrated.

OneNote Notebooks

  1. If the source team name and destination team name are different, and the destination team notebook is already provisioned, default mapping will apply. This means that contents in the source notebook will be automatically migrated to the destination notebook even though the team names are different.

  2. If the source team display name and the destination team display name are different, and the destination team notebook was not provisioned due to Microsoft limitations, the source notebook will be migrated as-is.

  3. Source default notebook content will be migrated but will not show as the default if the destination notebook has not been provisioned.

OneNote Tabs

  1. If the OneNote associated with the tab is not stored in the specified team, the tab will not be created at the destination. A warning message will be shown. This may be due to a changed personal OneDrive URL or from a lack of visibility into other teams and their migration status.

What happens if the tab migration fails?

If there are migration failures of OneNote tab migrations, perform "Reset Items" to reset errors before resubmitting the migration. Otherwise, all OneNote notebooks and tabs will be recreated.

Can the documents & tabs migration be skipped?

Yes, add Advanced Option TeamsSkipSiteAssets=1 in order to skip OneNote migration.

Migrating Conversations

Are all conversations migrated?

60 message threads (60 root messages + all replies) per team will be displayed in the destination team.

MigrationWiz will gather the total number of channels in each team  and then grab the most recent 60 threads in each team. The conversations will be distributed across those channels. For example, if you have six channels in a team, you will have ten message threads per channel. This number can be controlled with the TeamsMaxConversationPostPerTeam Advanced Option. Details on this process are found in the migration guide. 

The entire channel conversation history can also be downloaded as HTML in the ‘Conversation History’ tab.

How does MigrationWiz choose 'most recent'?

It is based on the age of the root message. If you reply to an old message, it will not be counted as the most recent.

Private Chats

Are private chats migrated? 

Yes, private chats, including 1:1 chats, group chats, and meeting chats are migrated.

Are the private chats rehydrated into Teams at the destination tenant?

No. This is currently a Microsoft API limitation.

What license is required to migrate Teams Private Chats?

Mailbox or UMB license.

Can Teams private chats be migrated as a standalone without migrating the rest of the mailbox items, or if the other mailbox items have already been migrated? 

Yes, just select the Teams private chat item type during ‘Start Migration’ and deselect the rest of the item types.

Can the ‘Migrated Teams Chat’ folder be renamed?

Yes, use the Advanced Option MigratedTeamsChatFolder=RenamedFolderName
Change the second part of the stream to the folder name you wish to map to on the destination. Example: MigratedTeamsChatFolder=My Teams Chat will appear as ‘My Teams Chat’ instead of ‘Migrated Teams Chat’.
This option should be added at the project level before starting the migration. If folder has to be renamed again after a migration pass, the older folder that was already migrated should be deleted, reset and re-run the migration.

Can the 'Migrated Teams Chat' folder be hidden after migration? 

Yes, use the Advanced Option HideMigratedTeamsChatFolder=1

By default, the 'Migrated Teams Chat' folder is visible after migration if the Advanced Options is not added. 

Is it possible to migrate Teams private chat for a specific duration? 

Yes, use the date filter in the Advanced Options configuration page.

Is pre-stage migration supported for Teams Private Chat?

Yes, for pre-stage migration, either select only ‘Mail’, only ‘Teams Private Chat’ or both.

Why must OneDrive migration be completed prior to migrating Teams Private Chat? 

All files or links shared in Teams Private Chats are stored in the sender’s OneDrive folder.
Migrating OneDrive ensures links or attachments within private chats will be mapped correctly and migrated over to the destination. Otherwise, migration will succeed but the links will not be accessible.

Migrating Guests

Are guests/external users migrated?

Guest access on the source will be migrated if the guest exists and guest permissions are enabled at the destination tenant prior to migration. This may be done via the Teams or Office 365 admin portal.

Post-Migration

Team members are missing at my destination. How do I resolve this?

Teams with a large number of members may take longer time to sync. To verify that all members have migrated:

  • Log into portal.azure.com.

  • Go to the migrated group (Team).

  • View the members list to verify that the correct number of members were migrated.

  • This should be synced to the Teams interface in the next few hours.

Government Migrations 

Can I migrate to or from a US Government tenant?

Yes, via Advanced Options. Refer to the migration guide.

Does GCC support the Teams application permission Advanced Option?

No, currently GCC does not support the use of application permission (UseApplicationPermission=1). Add the option UseDelegatePermission=1 instead.

Black Forest Tenant Migrations

Teams migration is currently not supported for Black Forest Tenants in the Microsoft Germany Datacenter, as it was not rolled out there to the best of our knowledge, nor could we obtain a test environment. For German customers in a .com Microsoft 365 instance, Teams and migrations to and from should work normally. For US Government tenants, we currently support it as a destination. Source is as yet untested.

Advanced Options

User Mapping Troubleshooting

If the user is not found at the destination (with or without mapping), MigrationWiz will throw a warning message indicating that the particular user is not found and will not be added to the migrated teams. To fix this, make the correction to user mapping and re-migrate with 'Team Permission' selected.

Does UserMapping refer to the UPN or to the SMTP?

UPN.

Was this article helpful?
0 out of 2 found this helpful