On Demand Migration Current

You can rename and map teams, or rename, map and merge one or more source teams to a specific team in the target tenant in two ways:

Mapping and renaming teams from the Teams list
Mapping, renaming and merging teams from a file

Mapping and Renaming Teams from the Teams list

Log in to Quest On Demand and choose an organization if you have set up 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.
Go to the Teams tab and select one or more teams from the Teams list that you want to rename and map.
Click More > Rename and Map. The New Teams & Groups Rename and Map Task wizard opens.
Step 1: Mapping options
1. Enter the information as described below:
  - Add prefix - specify a prefix for the team name.
  - Add suffix - specify a suffix for the team name.
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 mapping task completes.
  - Only in a case of failure - select this option to send the email if the mapping 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 Rename and Map Task.
  2. Source tenant - name of the 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.

The task is created. You can track its progress from the Tasks tab, view the summary on the Dashboard or monitor alerts and notifications from the Events tab.

Mapping, Renaming and Merging Teams from a File

To rename teams or merge one or more source teams to a specific team in the target tenant, a CSV file is used to indicate the mapping between source and target teams, as described below.

NOTE:

When teams are renamed and provisioned in the target tenant, Microsoft creates a default OneNote tab. Since ODM migration service is not aware of this default tab, any OneNote content that is migrated will retain the original name and will not appear in the default target OneNote tab of the renamed team.

There are two scenarios with OneNote migration when teams are merged:

When one or more teams are merged to a team with a different name in the target tenant, Microsoft creates a default OneNote tab for the renamed target team. Since ODM migration service is not aware of this default tab, any OneNote content that is migrated will retain the original name and will not appear in the default target OneNote tab of the renamed team.
When one or more teams are merged to a team with a preexisting team in the target tenant, contents in the OneNote tab in the target tenant is overwritten with the content from the source.

To create the mapping file:

Prepare a comma-separated values (CSV) file with the source and target team names.

TIP:

Export selected teams to a comma-separated values (CSV) and then edit this file. See Exporting Teams for more details.
You can download a CSV template when you start the New Mapping from File Task wizard and click Download Example File from the Mapping File step.
CSV file names with non-ASCII characters are not supported.

The header row defines the names of the source and target attributes used for mapping. Subsequent rows list the mapping values of the attributes.
The columns are as follows:
- Source Mailnickname - unique name of the source team. The following column header variations are supported: SourceMailNickname, Source MailNickname, Source MailNickName. The column header is case sensitive.
- Target Mailnickname - unique name of the target team. The following column header variations are supported: TargetMailNickname, Target MailNickname, Target MailNickName. The column header is case sensitive. You can merge multiple source teams to a single target team when you specify the same Target Mailnickname in a mapping file.
- Target Team Name - display name of the target team. The column header is case sensitive. If two or more records have the same Target Mailnickname then the Target Team Name for each record must be specified and must be the same.
Example 1: Row 2: Simple change of name

The name properties of the source team will change to the Target Mailnickname and Target Team Name respectively.

Example 2: Rows 3 and 4: Different target teams with the same display name

The Target Mailnicknames are different but the Target Team Names are the same. The Target Mailnickname takes precedence and the teams will be mapped to distinct Target Mailnicknames but the display name of each target team will be the same. It is recommended that you use unique display names to avoid confusion.

Example 3: Rows 5, 6 and 7: Merge multiple source teams with the same target team

The Target Mailnickname is the same. The teams will be merged with the same target team with the specified display name.
Save the CSV file. You may rename the file if needed.

To upload the mapping 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 Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
Click the Teams tab.
Click More > Map from File. The New Mapping from File Task wizard opens.
Step 1: Mapping file
1. Click Browse and select the CSV mapping file. The selected file name appears next to the Browse button.
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 mapping task completes.
  - Only in a case of failure - select this option to send the email if the mapping 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.
  2. Source tenant - name of the 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.

The task is created. You can track its progress from the Tasks tab, view the summary on the Dashboard or monitor alerts and notifications from the Events tab.

Provisioning Teams

The provisioning task help you with the following premigration preparations:

Provision teams in the target tenant.
Resolve naming conflicts.

Considerations

After all source teams are discovered you can begin provisioning teams on the target tenant with a Teams Provisioning Task. Verify that all associated accounts are matched or migrated before you create the provision task.
A Group Map task will be automatically created in the Accounts and User Data migration workspace of the project. The purpose of this task is to match the team-related group accounts so that the On Demand Migration for SharePoint service can use the mapping for membership migration.
If one or more new private channels or shared channels are added to a source team after provisioning, then you must re-provision the team in the target tenant to ensure that the SharePoint content is discovered for those new channels.
When teams are provisioned, the account that is assigned the Migration Manager role will be added to the source teams, private channels and shared channels to prepare for migrating the channel settings to the target tenant.
When teams are provisioned on the target tenant, a Discover SharePoint Contents Task is run automatically. The task discovers the corresponding SharePoint site collection and its contents listed in the SharePoint Contents tab.
When teams are provisioned on the target tenant, some scenarios like team renaming, multi-geo and others, will automatically trigger one or more SharePoint mapping tasks.
Teams in the target tenant may take up to 24 hours to be fully provisioned by Microsoft.

Starting the provisioning 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.
Select one or more teams from the Teams List View.
Click Provision. The New Teams Provisioning Task wizard opens.

Step 1: Provision Options

Choose from the following options if a team with the same name exists on target:
- Provision a new team on the target with the original name plus suffix - Select this option to provision a new team on the target tenant by adding a suffix to the team name.
  - New team display name suffix - The default suffix is Migrated. You can specify another suffix.
- Merge to the existing team on target - Select this option to merge a team in the source tenant with a team in the target tenant that has the same name. Then select an option if a team channel with the same display name already exists in the target team:
  - Provision a new channel on the target with the original name plus suffix - Select this option to provision a new team channel on the target tenant by adding a suffix to the channel name.
    - New channel display name suffix - The default suffix is Migrated. You can specify another suffix.
  - Merge source channel conversations with the Target channel - Select this option if the target channel is empty.

Preferred location in target multi-geo tenant - Leave the preferred data location as Default if the target is a multi-geo tenant and you have already configured a default geo location for the target tenant. All teams and groups will be migrated to the same region. To set up the default geo location, see Configuring the Migration Project. If you change the default settings, please allow at least 5 minutes for the new settings to take effect. Alternatively, select the geo location configured for the target tenant.

TIP: To migrate teams to different regions, the best practice is to create a collection of teams for each region (see Using Collections for Teams). Example collection names could be "Migrate to EUR", "Migrate to JPN" or "Migrate to NAM". Then use the collection as a filter to create the provision task.

For more information about multi-geo tenants, see Microsoft 365 Multi-Geo.

Suppress Group Welcome Message - Select this option to prevent spamming users with welcome messages when Teams are provisioned on the target tenant.

NOTE: Suppressing these messages may result in performance degradation due to issues with Microsoft’s synchronization behavior. We suggest you check the performance during the pilot migration.

Click Next.

Step 2: Channel Filter
With this filter, you can include or exclude specific channel types such as Private, or Shared. Standard channels are always included.
1. Private - select this option to include private channels.
2. Shared - select this option to include shared channels.
3. Click Next.
Step 3: Notification
1. Send notification email once the task is completed - select this option to send a notification email when a provisioning task completes.
  - Only in a case of failure - Select this option to send the email if the provisioning 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 4. 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 5: 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 Provision Teams.
  2. Source tenant - name of the 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.

The provisioning task is created. You can track its progress from the Tasks tab, view the summary on the Dashboard or monitor alerts and notifications from the Events tab.

Removing Teams

To manage large lists of teams in a project, you can remove one or more teams from the teams list view that you don't need for migration. The teams that are removed will remain in the source tenant and you must re-discover the teams in the project when you need them for migration.

When teams are removed, all associated items, mappings and migration information will also be removed from the project. When these teams are rediscovered, they will be treated as new teams in the project and the process of provisioning and migration of the teams and related items must be repeated.

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.
Select the Teams tab and select List View if not already selected.
Select the teams you want to remove.

TIP: Use filters, search or collections to quickly navigate through the list of teams.
Click More > Delete. The New Remove Team Mappings Task wizard starts.
Step 1: Description
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 Remove Teams.
  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.

Collecting Statistics

The Collect Team Statistics Task for Teams conducts an assessment of all teams in the source tenant and matching teams in the target tenant. It provides information like member count, content size (in GB), planner count and planner task count for the teams in the source tenant, and optionally in target tenant if the team is already provisioned.

Each Collect Team Statistics Task generates events. Events are milestones that a task achieves as it runs. For example, when a Collect Team Statistics Task starts, an event is logged and it appears in the events list. When the number of teams that are selected for assessment is large, the Collect Team Statistics Task divides the total number of teams into manageable sets. Each set is called a batch. When a batch of accounts is assessed, another event occurs.

In this topic:

Starting a Collect Team Statistics Task
Reviewing the Collect Team Statistics Task
Reviewing the statistics collected
Reviewing the events for the Collect Team Statistics Task

Starting a Collect Team Statistics 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 workspace.
Select the Teams tab and then select List View if not already selected.
Select the teams in the list from where you want to collect statistics. You can use search, filtering or collections to quickly navigate through the list of mailboxes. You can select the check box in the table header to select all the accounts.
Click Collect Statisticsfrom the Actions ribbon. The New Collect Statistics Task wizard opens.
Step 1:Collect Statistics Options
1. Choose from the following options
  - Include collection of statistics from target tenant - select this option to include the same teams from the target tenant and generate the Comparison Report. Statistics will be collected for the target tenant teams only if a provision task was previously run for the teams.
  - Collection levels:
    - Basic (Fast) - collect statistics about member count and content size (in GB) for the teams selected in the source and target tenant if provisioned.
    - Advanced (Slow) - collect statistics about member count and content size (in GB), planner count and planner task count for the teams selected in the source and target tenant if provisioned. The task requires more time to run.
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. Default name is Collect Team Statistics Task.
  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.
Review the statistics collected
1. Open the Teams workspace.
2. Select the Teams tab and then select List View if not already selected.
3. Review the statistics collected for each team. The statistics displayed depends on the option selected in the New Collect Team Statistics Task wizard.

Reviewing the Collect Team Statistics Task

Open the Tasks tab.
Select the Collect Statistics task for teams that you want to review.
In the task details pane that opens, the information presented is as described below:
1. Type - Type of the task. The type is collectstatistics.
2. Created - Date and time when the task was created.
3. Modified - Date and time when the task was last updated.
4. Status - 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) - The number of events that the task encountered.
8. From the task details pane, click Download Premigration Report. Download and save the ZIP file to a suitable folder, and extract the report.
  NOTE: Premigration reports are also available from the following tasks:
  
  Discover All
  Discover From File
  Provision

Reviewing the events for the Collect Team Statistics Task

Open the Tasks tab.
Select a Collect Statistics task for teams 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 task details pane that opens, the information presented is as described below:
1. Object - name of the team if applicable.
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 - the workspace from where the event was generated. The value is Teams Migration.