On Demand Migration Current

Verify the following requirements are met before migrating Microsoft Teams. If these actions are not performed, discovery, provision and migration tasks will fail or some data might be lost!

The following consents must be granted before Teams migration can be started

Migration - Basic,
Migration - Mailbox Migration
Migration - SharePoint
Migration - Teams

TIP: If the consents are not granted or expired, Discover Teams action is disabled and the following notification is displayed: Grant admin consent to the following Migration sub modules on the Tenants page for both source and target tenants: Basic, SharePoint, and Teams. Open Tenants page and grant the necessary Consents and Permissions so that the product can access the source and target tenants. You will be redirected to the Microsoft web site for granting admin consent. Once admin consent is granted, you can start discovering Teams.

IMPORTANT: The Tenant Administrator must open the OneNote application just once in the target tenant. It does not have to be opened or run by every user. If OneNote is not initialized before granting consent for Teams migration, the following error occurs: Unexpected response while attempting to register the tenant: AADSTSxxxxxx: The app needs access to a service ("https://*.onenote.com/")

User must be matched or migrated before using the On Demand Migration for Teams service.
Images, media files and documents referenced in one-on-one or group chats are stored in your OneDrive for Business folder. They must be migrated using the On Demand Migration for OneDrive service, before you migrate the chats.

Accounts joined to existing teams should be matched or migrated in the migration project.

Required permissions

Feature	Required permissions
Migrate conversations	Read all channel messages
	Have full access to the Chat Service Aggregator
	Have full access to the Skype Teams Service
	Create chat and channel messages with anyone's identity and with any time stamp
Migrate private chats	Read all chat messages
	Read and write user chat messages
Provision groups and teams	Read and write directory data
	Read and write all groups
Migrate files and OneNote items	Read and write all OneNote notebooks
	Read and write items in all site collections
	View and modify notes for all users
Migrate groups and teams membership	Read all users' full profiles
	Read or write user region
	Add and remove members from all teams
	Add and remove members from all channels

Temporary Migration Manager accounts

It is recommended to create or use source and target temporary Migration Manager accounts.
The temporary Migration Manager accounts should be granted the Global Administrator or Teams Administrator role on the tenants for which these account are used. The temporary Migration Manager accounts in the source and target tenant should have Teams license from the Microsoft 365 admin center.
Do not change your temporary Migration Manager accounts before completing the migration project.
You must remove the source and target temporary Migration Manager accounts for safety reasons after the migration is completed. These accounts can be removed from teams as described in Finalizing the Migration.

The target temporary Migration Manager account is used in (but not limited to) the following scenarios:

It creates and owns the provisioned target teams.
It is added to all target teams and Microsoft 365 Groups as a member and an owner, and to all target private channels as an owner.
It is used to perform the Teams migration and is displayed as the owner of all migrated conversation and chat messages and planner tasks on the target.
It is added to all the chats (both group chats and private chats) as a participant during chats migration, and then removed from the migrated chats as soon as the chat migration is complete. All migrated chats of the target temporary Migration Manager account are hidden when the chat migration is complete.

Discovering Groups

In this topic:

Discovering all groups
Discovering groups from a file
Reviewing the Discover Groups task
Reviewing the Discover Groups task events

Discovering all groups

This is the simplest approach which uses the Discover Groups tasks to inspect the source tenant and discover all the Microsoft 365 Groups.

To start the Discover Groups task:

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click the Teams tile, or click Open from the Teams tile to open the Teams dashboard.
Click Discover M365 Groups from the Groups tile in the Teams dashboard
- or -

Select the M365 Groups tab and select List View if not already selected. Then click Discover Groups > Discover All from the Actions menu.
The New Groups Discovery Task wizard opens.
Step 1: Discovery Options
1. Click Next.
Step 2: Notification
1. Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
  - Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
3. Click Next.
Step 3: Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
2. Click Next.
Step 4: Summary
1. Verify the task specifications as described below:
  1. Name - name of the task. You can specify a custom name. The default name is Discover Groups.
  2. Source tenant - name of the source tenant in this project.
  3. Target tenant - name of the target tenant in this project.
  4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Discovering Groups from a File

When you have a large set of groups but you want to migrate a subset of those groups, you can start the discovery process by using a CSV file. The CSV file lets you specify the groups that you want to discover and ignore the rest. This is a two-step process:

Step 1: Preparing the CSV file

Log in to the Microsoft 365 admin center (https://admin.microsoft.com) with the credentials of your source tenant administrator.
From the navigation pane, click Active groups.
Select the Microsoft 365 tab in the Active Groups page.
Click Export and then click Export groups in this list. A Groups.csv file will be downloaded to your computer.
Edit the CSV and retain the groups you want to discover that are not associated with Teamsand delete the rest. You can filter that data based on the Has Teams column to get a list of groups that are not associated with teams. If you retain a row that references a group associated with a team, the group will be ignored during discovery. Then retain the Group ID and Group name columns.
Save the CSV file. You may rename the file if needed.

Step 2: Starting the Discover Groups Task

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click the Teams tile, or click Open from the Teams tile to open the Teams dashboard.
Click the M365 Groups tab and select List View if not already selected. Then click Discover Groups > Discover from file from the Actions menu.
The New Groups Discovery Task wizard opens.
Step 1: Discovery Options
1. Click Browse and select the CSV that contains the Group IDs and Group names of the groups that you want to discover.
2. Click Next.
Step 2: Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
2. Click Next.
Step 3: Summary
1. Verify the task specifications as described below:
  1. Name - name of the task. You can specify a custom name. The default name is Discover Groups.
  2. Source tenant - name of the source tenant in this project.
  3. Target tenant - name of the target tenant in this project.
  4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Reviewing the Groups Discovery Task

Open the Tasks tab.
Select the task that you want to review. The default name is Discover.
In the task details pane that opens, the information presented is as described below:
1. Type - Type of the task. The type is discovergroups.
2. Created - Date and time when the task was created.
3. Modified - Date and time when the task was last updated.
4. State - State of the task.
5. Last Operation - The action that was most recently performed in this task.
6. Schedule - Date and time when the task started. Now indicates that the task started immediately after the task was created.
7. Events (number) - Number indicates the count of events that the task encountered. The values indicate the type of the events and the event count for each type.
If you selected the option to collect statistics in the New Groups Discovery Task wizard, you will see and additional task for Collect Plan and Task statistics for Groups. Click the task to view the corresponding details in the details pane.

Reviewing the Groups Discovery Task Events

Open the Tasks tab.
Select the task that you want to review.
In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
Select an event that you want to review. In the event details pane that opens, the information presented is as described below:
1. Object - Name of the group.
2. Task - Name of the task.
3. Time - Date and time when the event occurred.
4. Category - Type of task. the value is Application.
5. Source - Name of the On Demand Migration service.

Discovering Teams and Groups

Every team is associated with a Microsoft 365 Group, but there are groups that are not associated with teams. In this topic, the term team means a Microsoft Team and includes its associated group, and the term group means a Microsoft 365 Group that is not associated with a team.

NOTE: This topic explains the process to discover both teams and groups. If you want to discover only teams, see Discovering Teams. If you want to discover only groups that are not related to teams, see Discovering Groups.

In this topic:

Discovering all teams and groups
Discovering teams and groups from a file
Reviewing the Discover task
Reviewing the Discover task events

Discovering all teams and groups

This is the simplest approach which uses the Discover tasks to inspect the source tenant and discover all the teams.

To start the Discover task:

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
Click Discover > Discover All from the Teams dashboard.
The New Teams & Groups Discovery Task wizard opens.
Step 1: Discovery Options

NOTE: The Azure AD administrator account will be added to the discovered Teams and Groups.
1. All Teams - select this option to discover all Microsoft Teams.
2. All Groups - select this option to discover all Microsoft 365 Groups without Teams.
3. All Teams and Groups - select this option to discover Microsoft 365 Groups and Teams.
4. Click Next.
Step 2: Notification
1. Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
  - Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
3. Click Next.
Step 3: Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
2. Click Next.
Step 4: Summary
1. Verify the task specifications as described below:
  1. Name - name of the task. You can specify a custom name. The default name is Discover.
  2. Source tenant - name of the tenant where the statistics will be collected.
  3. Target tenant - name of the target tenant in this project.
  4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Discovering teams and groups from a file

This step is required if you plan to discover teams and groups using a CSV file. When you have a large set of teams and groups but you want to migrate a subset of the objects, the CSV file lets you specify the teams and groups that you want to discover and ignore the rest. You can then use this file in the New Teams & Groups Discovery Task as described in this topic to discover the teams from the source tenant.

Step 1: Preparing the CSV file

Log in to the Microsoft 365 admin center (https://admin.microsoft.com) with the credentials of your source tenant administrator.
From the navigation pane, click Active groups.
Select Microsoft 365 tab in the Active Groups page
Click Export and then click Export all groups. A Groups.csv file will be downloaded to your computer.
Edit the CSV file and retain the Group ID and Group name columns. Then retain the teams and groups you want to discover and delete the rest.
Save the CSV file. You may rename the file if needed.

Step 2: Starting the Discover Task

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
Click Discover > Discover from file from the Teams dashboard.
The New Teams & Groups Discovery Task wizard opens.
Step 1: Discovery Options
1. Click Browse and select the CSV that contains the Group IDs and Group names of the teams that you want to discover.
2. Click Next.
Step 2: Notification
1. Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
  - Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
3. Click Next.
Step 3: Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
2. Click Next.
Step 4: Summary
1. Verify the task specifications as described below:
  1. Name - name of the task. You can specify a custom name. The default name is Discover.
  2. Source tenant - name of the tenant where the statistics will be collected.
  3. Target tenant - name of the target tenant in this project.
  4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Reviewing the Discover Task

Open the Tasks tab.
Select the task that you want to review. The default name is Discover.
In the task details pane that opens, the information presented is as described below:
1. Type - type of the task. The type is discoverteams.
2. Created - date and time when the task was created.
3. Modified - date and time when the task was last updated.
4. State - state of the task.
5. Last Operation - the action that was most recently performed in this task.
6. Schedule - date and time when the task started. Now indicates that the task started immediately after the task was created.
7. Events (number) - number indicates the count of events that the task encountered. The values indicate the type of the events and the event count for each type.
If you select the options to collect statistics in the New Teams & Groups Discovery Task wizard, you will see additional tasks: Collect Plan and Task statistics for Teams and Groups and Collect Message statistics for Teams. Click each task to view the corresponding details in the details pane.

Reviewing the Discover Task Events

Open the Tasks tab.
Select the task that you want to review.
In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
Select an event that you want to review. In the event details pane that opens, the information presented is as described below:
1. Object - name of the team or group discovered.
2. Task - name of the task.
3. Time - date and time when the event occurred.
4. Category - type of task. the value is Application.
5. Source - name of the On Demand Migration service

Managing Groups with Collections

Migrating large numbers of groups requires careful planing. The groups could belong to different offices and geographical locations or sensitive departments. Migrating groups of Finance or Legal departments require special care. Organize the groups into collections to make large group lists more manageable.

Working with the Collection Dashboard

The Collection Dashboard shows the collection-specific summary, allows you to see group added to it, create tasks for them, and monitor the progress of tasks.

To view the collection dashboard for an existing collection
1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
2. From the navigation pane, click Migration to open the My Projects list.
3. Create a new project or open an existing project.
4. From the project dashboard, click Open in the Teams tile to open the Teams migration workspace.
5. From the top-right corner of the migration workspace, click Select Collection and then select the collection to view. The collection Dashboard is displayed.
6. Click the M365 Groups tab. You will see the list of groups that belong to the collection.

To see the tasks for collection-specific accounts, use the corresponding tile on the collection Dashboard or open the Tasks tab.

To see the events related to the collection, use the corresponding widget on the collection Dashboard or open the Events tab.

To rename or delete the collection, click the corresponding buttons in the menu.
To return to the project dashboard, click the project name in the navigation bar.

Creating a Collection manually

From the project dashboard, click Open in the Teams tile to open the Teams dashboard.
From the top-right corner of the migration workspace, click Select Collection > + New Collection
Enter a collection name and click Save to add this collection to the project.

Adding groups to Collections

You can add groups to collections in several ways:

Select the groups and create a new collection for them
Select the groups and add to an existing collection
Use a CSV file to add groups to a new or existing collection from the Teams tab
Use a CSV file to add groups to an existing collection from the Teams collection dashboard

To add selected groups to a new collection:

From the project dashboard, click Open in the Teams tile to open the Teams dashboard.
Click the M365 Groups tab and select List View if not already selected.
Select the groups you want to add to the collection.
From the actions toolbar, click New Collection. The New Collection dialog opens.
Enter a collection name in the Collection name field and click Save to add the selected groups to the collection.

To add selected groups to an existing collection:

From the project dashboard, click Open in the Teams tile to open the Teams dashboard.
If you need to create a new collection:
1. From the top-right corner of the migration workspace, click Select Collection > + New Collection
2. Enter a collection name and click Save to add this collection to the project.
Click the M365 Groups tab.
Select the groups you want to add to an existing collection.
From the actions toolbar, click Add To Collection. The Add to existing collection dialog opens.
Select a collection from the Collection name dropdown and click Save to add the selected groups to the collection.

To add groups from a CSV file to a new or existing collection from the M365 Groups tab:

This is a two-step process as described below to add teams to an existing collection from the M365 Groups tab:

Step 1: Prepare the CSV file

NOTE: CSV file names with non-ASCII characters are not supported. Teams in the CSV that have not been discovered cannot be added to a collection.

Use the format shown below to prepare the CSV file. The minimal set of columns required are shown.

TIP: You can export the selected groups to a CSV file and then add the Collection column and retain the Source MailNickname column. All other columns in the exported CSV file will be ignored so you can remove those columns if you want.

Collection - Column header for the collection name
Source MailNickname - Email alias of the M365 group. You can get the Source MailNickname property of the teams when you export groups to a CSV file. Source MailNickname values are case-sensitive.

Step 2: Import the CSV file

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click the Teams tile, or click Open from the Teams tile to open the Teams migration workspace.
Open the M365 Groups tab.
From the actions toolbar, click More Actions > Import Collections. The Import Collections from File dialog opens.
Select Teams/M365 groups from the Specify kind dropdown.
Click Browse and select the CSV file. The selected CSV file name appears.
Click Import.

NOTE: If a collection in the CSV does not exist, a new collection will be created with the name specified in the CSV.

To add groups from a CSV file to an existing collection from the Teams Collection dashboard:

This is a two-step process as described below:

Step 1: Prepare the CSV file

NOTE: CSV file names with non-ASCII characters are not supported. Groups in the CSV that have not been discovered cannot be added to a collection.

Use the format shown below:

MailNickName - Email alias of the M365 group. You can get the MailNickName property of the groups when you export groups to a CSV file. MailNickName values are case-sensitive.

Step 2: Import the CSV file

From the project dashboard, click Open in the Teams tile to open the Teams migration workspace.
From the top-right corner of the migration workspace, click Select Collection and then select the collection.
Click Fill From File from the Teams collection Dashboard menu. The Fill from File dialog opens.
Click Browse and select the CSV file that you created.
Click Populate to add the groups from the file to the collection.