Mapping Teams
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 Automatically
- 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 to open the Teams dashboard.
- Click the Teams tab and select one or more teams that you want to rename and map.
- Click More Actions and then click Rename and Map. The New Teams & Groups Rename and Map Task wizard opens.
- Step 1: Mapping options
- Enter the information as described below:
- Add prefix - specify a prefix for the team name.
- Add suffix - specify a suffix for the team name.
- Click Next.
- Step 2: Notification
- 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.
- Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
- Click Next.
- Step 3: Schedule
- 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.
- Start - enter the start time for the task.
- Click Next.
- Step 4: Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. The default name is Rename and Map Task.
- Source tenant - name of the tenant in this project.
- Target tenant - name of the target tenant in this project.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- 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 Manually 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.
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. |
- The header row defines the names of the source and target attributes used for mapping. Subsequent rows list the mapphing 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.

|
NOTE: File names with non-ASCII characters are not supported. |
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 Actions and then click Map from File. The New Mapping from File Task wizard opens.
- Step 1: Mapping file
- Click Browse and select the CSV mapping file. The selected file name appears next to the Browse button.
- Click Next.
- Step 2: Notification
- 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.
- Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
- Click Next.
- Step 3: Schedule
- 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.
- Start - enter the start time for the task.
- Click Next.
- Step 4: Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name.
- Source tenant - name of the tenant in this project.
- Target tenant - name of the target tenant in this project.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- 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 to perform the following:
- Create Microsoft 365 Groups on the target tenant.
- Resolve naming conflicts.
- Provision teams in the target tenant.
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.
Teams in the target tenant may take up to 24 hours to be fully provisioned by Microsoft
To start a Teams 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 tenant is a multi-geo tenant (see Microsoft 365 Multi-Geo). All teams and groups will be migrated to the same region as the target admin. Alternatively, select the geo location configured for the target tenant.

|
TIP: To migrate teams/groups to different regions, the best practice is to create a collection for each region (see Managing Teams with Collections ) and add the teams/groups to the appropriate collection. Example collection names are "Migrate to EUR", "Migrate to JPN" and "Migrate to NAM". Use the collection as a filter to create the provision task. |
- 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: Notification
- 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.
- Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
- Click Next.
- Step 3. Schedule
- 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.
- Start - enter the start time for the task.
- Click Next.
- Step 4: Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name.
- Source tenant - name of the tenant in this project.
- Target tenant - name of the target tenant in this project.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- 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 Statistics Task for Teams conducts an assessment of selected teams in the source tenant and provides information like member count, content size (in GB), planner count and planner task count for the teams selected in the source tenant, and optionally in target tenant if the team is already provisioned.
Each Collect Statistics Task generates events. Events are milestones that a task achieves as it runs. For example, when a Teams Collect 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 Teams Collect 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 Teams Collect 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 Teams Collect Statistics Task wizard opens.
- Step 1:Collect Statistics Options
- Choose from the following options
- Include collection of statistics from target tenant - select this option to include the same teams from the target tenant. Statistics will only be collected for the target tenant teams if a provision task has been executed for the team previously.
- 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.
- Click Next
- Step 2:Schedule
- 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.
- Start - enter the start time for the task.
- Click Next.
- Step Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. Default name is Collect Statistics.
- Source tenant - name of the tenant where the statistics will be collected.
- Target tenant - name of the target tenant in this project.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- 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 Teams Collect Statistics Task
- Select 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:
- Type - Type of the task. The type is collectstatistics.
- Created - Date and time when the task was created.
- Modified - Date and time when the task was last updated.
- Status - State of the task.
- Last Operation - The action that was most recently performed in this task.
- Schedule - Date and time when the task started. Now indicates that the task started immediately after the task was created.
- Events (number) - The number of events that the task encountered.

Reviewing the events for the Teams Collect Statistics Task
- Select 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:
- Object - Not applicable for this event.
- Task - Name of the task.
- Time - Date and time when the event occurred.
- Category - Type of task. the value is Application.
- Source - the workspace from where the event was generated. The value is Teams Migration.

Reviewing the statistics collected
- Open the Teams workspace.
- Select the Teams tab and then select List View if not already selected.
- Review the statistics collected for each team. The statistics displayed depends on the option selected in the New Teams Collect Statistics Task wizard.
Premigration Assessment for Teams
On Demand Migration analyzes your environment and tracks potential problems, misconfiguration, and risks that might adversely affect the migration. Use Assessment view to see the summary reports on the discovered data and use the automatic filters to quickly select certain items.
The following reports are available for Teams:
- Workflow - (deprecated) Teams sorted by completed workflow
- Discovered
- Processed
- Migrated
- Teams- Teams sorted by processing status
- Idle
- In progress
- Needs your attention
- Teams By Size
- Teams By Last Activity Time
- Teams By Channel Count
- Teams By Member Count
Once you handle the issues, if any, go to List View screen. You are ready to start the migration.