Chat now with support
Chat with Support

On Demand Migration Current - User Guide

About On Demand Migration Working with On Demand Migration Account Migration Mailbox Migration OneDrive Migration Microsoft Teams Migration Microsoft 365 Groups Migration SharePoint Migration Public Folders Migration Power BI Migration Troubleshooting Finalizing the Migration Appendix A: Using PowerShell Appendix B: How Queuing Works

Teams Migration Workspace

In this topic:

NOTE: The Teams migration workspace is common for the Teams, M365 Groups and Chats migration services. See Migrating Groups for details about M365 Groups.

Dashboard

NOTE: If the Teams license check fails, verify that the source and target tenants are valid. Then run the PowerShell commands in Quest KB article 337302 to confirm that the tenant administrator account used to grant consent has TeamspaceAPI activated.

The components of the dashboard are as described below:

Notification panel - presents relevant information and shortcuts to migration activities. The notification panel is displayed across all tabs.

Dashboard Menu - contains the following links to common activities in the migration process.

  • Discover - starts the New Teams & Groups Discovery Task wizard to collect information about accounts in the source tenant. For more information see Discovering Teams and Groups.
  • Configure Project - starts the Edit Project wizard for Teams. You can specify default settings as described in the Configuring the project section.

Dashboard Tiles

  • Getting Started - displays a summary of the various actions for preparing and migrating teams. Click Quick Help to open the Quick Help dialog. Then click the Teams tab to see help topics related to Teams, or click the Groups or Chats tab to see help topics related to Groups or Chats respectively.

  • Teams - displays a summary of the teams in various migration states. Click Show All to open the Teams List view to inspect the teams.
  • M365 Groups - displays a summary of the M365 Groups in various migration states. Click Show All to open the Groups List view to inspect the groups.
  • Chats - displays a summary of chats in various migration states.
  • Tasks - displays the five most recent tasks that were completed in the Teams migration workspace. The title displays the total number of tasks. Click Show All to open the Tasks List view.
  • Events - displays the five most recent events that were completed in the Teams migration workspace. The title displays the total number of events. Click Show All to open the Events List view.

Teams

The Teams List View is comprised of the following components:

Notification panel - presents relevant information and shortcuts to migration activities.

Filter panel - consists of predefined filters for the Teams List view and tabs to switch between the Teams List view and the Assessment view. See Filtering for more information about working with filters. The predefined filters are:

  • Teams - returns a list of teams based on the migration state of the team.
  • Teams By Size - returns a list of teams based on the size of a team. Valid ranges are More than 1GB, 100MB - 1GB, 10MB - 100MB, Less than 10MB. The dropdown also shows the number of teams in the list for each range.
  • SharePoint - returns a list of teams based on the nature of the SharePoint site linked to the team. Valid values are Customized and Standard.

List View Actions Menu - contains links to teams migration activities and the search box. Each action is explained in greater detail in subsequent topics. See Searching for more information about working with the search box.

List View - displays information about teams in the source and target tenants. Use the Edit Columns to show or hide columns in the list. The columns are as described below:

  • Team Name - name of the team in the source tenant.
  • Migration State - status of the task in the migration process. Values are as listed below:
    • Discovered - team discovered in the source tenant.
    • Exists in target - team in the source tenant exists in the target tenant.
    • Provisioning - started provisioning team in the target tenant.
    • Provisioned - team provisioned successfully in the target tenant.
    • Provisioned with issues - Team provisioned in the target tenant but there were issues during provisioning.
    • Provision failed - started provisioning team in the target tenant.
    • Queued - team is waiting for migration service resources to be available. For more information, see How Queuing Works.
    • Migrating - team migration in progress.
    • Partially migrated - team migration completed but some components were not migrated.
    • Partially migrated with issues - team migration completed some components were not migrated and due to issues during migration.
    • Migrated - team migrated successfully to the target tenant.
    • Migrated with issues - team migration completed but there were issues during migration.
    • Migration failed - team could not be migrated.
  • SharePoint - nature of the SharePoint site linked to the team. Values are as described below:
    • <no-value> - SharePoint content has not be discovered yet.
    • Standard - there is at most 1 SharePoint site and 4 Lists in the SharePoint site collection
    • Customized - there are more than 1 site and 4 Lists in the SharePoint site collection

    NOTE: The SharePoint status is available only after the New Teams Provisioning Task is run.

  • Channels - total number of channels in the source tenant team.
  • Source Members - total number of members in the source tenant team.
  • Target Members - total number of members in the target tenant team.
  • Source Files (GB) - total size in GB of files across all public channels in the source tenant.
  • Target Files (GB) - total size in GB of files across all public channels in the target tenant.
  • Source Messages - total number of messages in the source tenant team.
  • Migrated Messages - number of messages migrated to the target tenant team.
  • Target Messages - total number of messages in the target tenant team.
  • Source Plans - total number of plans in the source tenant team.
  • Migrated Plans - number of plans migrated to the target tenant team.
  • Target Plans - total number of plans in the target tenant team.
  • Source Tasks - total number of tasks in the source tenant team.
  • Migrated Tasks - number of tasks migrated to the target tenant team.
  • Target Tasks - total number of tasks in the target tenant team.
  • Source SharePoint site Url - SharePoint site URL of the source team. Available when the team is provisioned in the target tenant.
  • Target SharePoint site Url - SharePoint site URL of the target team. Available when the team is provisioned in the target tenant.
  • Mapped to Different SharePoint site Url - indicates whether or not the team's SharePoint site is mapped to a different url in the target tenant.
  • Progress (%) - migration progress indicated as a percentage.
  • Last Activity - date and time of the last action performed on the team record.
  • Created - date and time the team record was created.
  • Last Statistics Collected Date - date and time when the most recent statistics were collected.
  • Target Team Name - name of the team in the target tenant.
  • Source MailNickname - email alias of the associated Microsoft 365 Group in the source tenant.
  • Target MailNickname - email alias of the associated Microsoft 365 Group in the target tenant. Available when the team is provisioned in the target tenant.
  • IsArchived - indicates whether the team is archived. Archived teams can be migrated like any other team.
  • Collections - indicates the most recent collection where the corresponding Team is added and the number of additional collections that also contain this object.
  • Source Team URL - URL of the source team.
  • Target Team URL - URL of the target team. Available when the team is provisioned in the target tenant.
  • Source Group ID - unique identifier of the team or group in the source tenant.
  • Target Group ID - unique identifier of the team or group in the target tenant. Available when the team is provisioned in the target tenant.
  • Source SMTP Address - SMTP address of the Office 365 group of the source team.
  • Target SMTP Address - SMTP address of the Office 365 group of the source team. Available when the team is provisioned in the target tenant.
  • Source Team Owner UPNs - User Principal Names of the source team owners. Up to 5 names are listed.
  • Target Teams Owner UPNs - User Principal Names of the target team owners. Up to 5 names are listed. Available when the team is provisioned in the target tenant.

Teams Assessment View

See the Premigration Assessment for Teams for the complete list of available reports.

Team Details

When you select a team from the List View, the Team Detail pane opens. The information in the pane is described below:

  • View AI Summary - This link is available if you opted for the AI feature in the organization you created (see Organizations and Regions), and the task is a migration task that supports the AI migration assistant and you selected the Generate AI summary option in the Reporting step of the migration wizard. Click this link after the task has completed, to view the AI-generated migration summary.

    NOTE: The View AI Summary link may take a while to appear depending on the volume of tasks and objects being migrated. If this is the first time you have selected this option, the Quest Policies prompt appears. Read the Quest AI Terms of use and click Accept to proceed. This s a one-time acceptance prompt and your acceptance covers all migration tasks that support the AI migration assistant.

  • Go to SharePoint Sites - link to the SharePoint Site Contents list view with all the sites associated to the team including sites for private and shared channel. Reprovision teams if you don't see this link.
  • Description - name of the team in the source tenant.
  • Visibility - indicates whether the source tenant team is Public or Private.
  • Is Archived - indicates whether the source tenant team is archived.
  • SharePoint Customized - status of the selected account. Valid values are New, In Progress, Failed and Completed.
  • Source Location - geo location of the source team. The geo location could be blank if your source tenant team is not geo-located.
  • Source Url - SharePoint site URL of the source team. Available when the team is provisioned in the target tenant.
  • Target Location - geo location of the target team. This value appears when the team is provisioned and will reflect the preferred location specified in the New Teams Provisioning Task wizard. The geo location could be blank if your target tenant team is not geo-located.
  • Target Url - SharePoint site URL of the target team. Available when the team is provisioned in the target tenant.
  • Owner count - number of owners of the source team. A team can have up to 100 owners.
  • Member count - number of members in the source tenant team.
  • Migrated messages count - number of messages migrated to the target tenant team.
  • Archive messages count - number of archived messages in the source tenant team.
  • Last Operation - the most recent operation performed on the team. Valid values are Discovered, Provisioned, and Migrated.
  • Events - count of the events that occurred during one or more tasks.
  • Tasks - list of tasks invoked for the selected team.

Team Content

The Team Content tab presents a list of teams and its components along with the count of child items of the object type. When you open the Team Content tab, the list view initially displays all the teams and their migration state along with the total count of the team components of each team: Channel, Planner, Mailbox, Team membership, SharePoint Content* and SharePoint Site*. For each team component you can additionally view its components and their child item counts as well.

* Example: Consider a team with multiple private channels A and B.

If you select the SharePoint Standard option in the New Teams Migration Task wizard, then the following items are displayed in the Team Content view with type "SharePoint List" after migration.

Type Name
SharePoint List Documents - team site name
SharePoint List Documents - private channel A site name
SharePoint List
 Documents - private channel B site name

If you select the SharePoint Standard and Customized option in the New Teams Migration Task wizard, then the following items are displayed in Team Content view with type "SharePoint Site" after migration.

Type Name
SharePoint Site Site - team site name
SharePoint Site Site - private channel A site name
SharePoint Site
 Site - private channel B site name

To display the contents of a specific team:

  1. Select the team to open the details pane on the right hand side.
  2. Click Show Content. The components of the selected team are displayed in the list view along with the migration state and child item counts for each component. In the details pane, the Show Parent link is activated and the Show Content link is deactivated.

NOTE: Components of a team can be displayed when teams are migrated through a new project created after the Jan 10, 2023 release.

To display the parent of a specific team component:

  1. Select the team component to open the details pane on the right had side.
  2. Click Show Parent. The parent team is displayed in the list view along with the migration state and the total count of the team components. In the details pane, the Show Content link is activated and the Show Parent link is deactivated.

The components of teams are migrated when you start a migration task with the New Teams Migration Task wizard and select the team component types to migrate.

NOTE: The Events property value in the detail pane for a selected child component will be zero.

Filter panel - consists of predefined filters for the Teams List view and tabs to switch between the Teams List view and the Assessment view. See Filtering for more information about working with filters. The predefined filters are:

  • Status - migration state of the team.
  • Type - object type: Team, Channel, Planner, Mailbox, team membership or SharePoint Content.

List View - displays information about teams in the source and target tenants. Use the Edit Columns List View Actions Menu to show or hide columns in the list. The columns are as described below:

  • Type - object type: Team, Channel, Planner, Mailbox, membership or SharePoint Content.
  • Name - name of the object
  • Migration State - status of the task in the migration process. Values are as listed below:
    • Discovered
    • Exists in target - object in the source tenant exists in the target tenant
    • Mapped
    • Provisioning
    • Provisioned
    • Provision failed
    • Migrating
    • Partially migrated
    • Partially migrated with issues
    • Migrated
    • Migrated with issues
    • Migration failed
  • Items to migrate - the count of child items of the object. For each team, the count indicates the total number of child components of the team. For each team components the item counts displayed are as described below:
    • Planner: number of Planner tasks
    • Channel: number of messages
    • Mailbox: the team mailbox. The count is always 1
    • Membership: number of team members
    • SharePoint Content: number of sites
  • Processed - the number of items considered for migration.
  • Progress (%) - migration progress in percentage. If a team component is not selected for migration in the New Teams Migration Task wizard, this value does not exist for the component.

Chats

The Chats List View displays Chats between one or more matched users between a source and target tenant.

The Chats List View is comprised of the following components:

Notification panel - presents relevant information and shortcuts to migration activities.

Filter panel - consists of predefined filters for the Chats List view . See Filtering for more information about working with filters. The predefined filters are:

  • Chats - returns a list of chats based on the migration state of the team.
  • ODM Licensed - returns a list of user account with ODM license status. Values are Yes and No.
  • Account Type - returns a list of user accounts based on their mailbox type. Values are Mailbox-Enabled User and Non-Mail-Enabled User.

List View Actions Menu - contains links to chat migration activities and the search box. Each action is explained in greater detail in subsequent topics. See Searching for more information about working with the search box.

List View - displays information about teams in the source and target tenants. Use the Edit Columns to show or hide columns in the list. The columns are described as below:

  • User Name - name of the user account.
  • Migration State - migration status of chats from discovery to successful migration. Values are Discovered, Migrating, Partially migrated, Partially migrated with Issues, Migrated, Migrated with Issues, Migration Failed.
  • Account Type - indicates the mailbox type of the user account. Values are Mailbox-Enabled User and Non-Mail-Enabled User.
  • ODM Licensed - indicates whether or not an On Demand Migration user account license has been consumed when the account migration task is started. Values are Yes, No, Not required.
  • Account Matching -(deprecated)
  • OneDrive Status - migration status of the OneDrive files for this user.
  • Mailbox Status - migration status of a user's mailbox. It is a best practice to migrate a mailbox before chats are migrated for any user. Values are Discovered, Matched, Migrating, Migrated, Migrated with Issues, Migration Failed, Switched, and Migration Stopped.
  • Migrated Chats - number of chats that have been migrated.
  • Archived Chats - indicates whether or not the archive option is selected during a chat migration. If the value is Yes, chats belonging to this user cannot be archived again.
  • Message Count (< 180 days) - number of chat messages generated by the user in the last 180 days. There is a latency of 24-48 hours from the time a message is created.
  • Last Activity (< 180 days) - most recent activity in the last 180 days. This data is provided by Microsoft based on user activity in Microsoft Teams.
  • Total Chats - total number of chats in the source tenant.
  • Source UPN - User Principal Name (UPN) of the source account.
  • Target UPN - User Principal Name (UPN) of the target account.
  • Collections - indicates the most recent collection where the corresponding Chat is added and the number of additional collections that also contain this object.

Chat Details - When you select a chat from the List View, the Chat Detail pane opens. The information in the pane is described below:

  • View AI Summary - This link is available if you opted for the AI feature in the organization you created (see Organizations and Regions), and the task is a migration task that supports the AI migration assistant and you selected the Generate AI summary option in the Reporting step of the migration wizard. Click this link after the task has completed, to view the AI-generated migration summary.

    NOTE: The View AI Summary link may take a while to appear depending on the volume of tasks and objects being migrated. If this is the first time you have selected this option, the Quest Policies prompt appears. Read the Quest AI Terms of use and click Accept to proceed. This s a one-time acceptance prompt and your acceptance covers all migration tasks that support the AI migration assistant.

  • Source Email - source chat email
  • Target Email - target chat email
  • Total chats - total number of chats in the source tenant.
  • Migrated Chats - number of chats that have been migrated.
  • Tasks - list of tasks invoked for the selected team.
  • Events - count of the events that occurred during one or more tasks.

Configuring the project

Before you begin, you must configure the teams migration project as described below:

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migrate > Projects to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click Teams from the project tiles, or click Open from the Teams tile to open the Teams migration workspace.
  5. Click Configure Project. The Edit Project wizard for Teams starts. You can specify default settings as described below:
  6. Project Settings
    1. Set Migration Defaults - specify a Default target user to use as the team owner when the existing owner has no match on the target tenant. Then click Finish to save the setting.
    2. Teams Migration Option - select Skip private channels during provisioning and migration to prevent the provisioning of and migration of private channels. However, if private channels are already provisioned, this setting will be ignored and private channel content will be migrated.
    3. Chat Archive Setting - specify a Folder name for archived files for archiving HTML chat files
    4. Click Next.
  7. Migration Service Accounts
    1. Displays the current source and target tenant names along with the username that has granted consents to the tenant. If consents are missing for one or both tenants, then a warning message is shown to check the consents.
    2. Click Back to revise or review a previous step or click Finish to save the configuration.

 

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

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:

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migrate > Projects to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click Teams from the project tiles, or click Open from the Teams tile to open the Teams migration workspace.
  5. Click Discover > Discover All from the Teams dashboard.
  6. The New Teams & Groups Discovery Task wizard starts. Each step is described below:
  7. 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.
  8. 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.
  9. 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.
  10. 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.

Preparing the CSV file

  1. Log in to the Microsoft 365 admin center (https://admin.microsoft.com) with the credentials of your source tenant administrator.
  2. From the navigation pane, click Active groups.
  3. Select Microsoft 365 tab in the Active Groups page
  4. Click Export and then click Export all groups. A Groups.csv file will be downloaded to your computer.

  5. 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.

  6. Save the CSV file. You may rename the file if needed.

Starting the Discover Task

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migrate > Projects to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
  5. Click Discover > Discover from file from the Teams dashboard.
  6. The New Teams & Groups Discovery Task wizard starts. Each step is described below:
  7. 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.
  8. 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.
  9. 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.
  10. 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

  1. Open the Tasks tab.
  2. Select the task that you want to review. The default name is Discover.
  3. 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.

  4. 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

  1. Open the Tasks tab.
  2. Select the task that you want to review.
  3. In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
  4. 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

Discovering Teams

In this topic:

Discovering all Teams

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

To start the Discover Teams task:

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migrate > Projects to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
  5. Click Discover Teams from the Teams tile in the Teams dashboard

    -or-

    Select the Teams tab and select the List View if not already selected. Then click Discover Teams > Discover All from the Actions menu.

  6. The New Teams Discovery Task wizard starts. Each step is described below:
  7. Discovery Options

    1. Click Next.
  8. 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.
  9. 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.
  10. 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 Teams.
      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 from a file

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

Preparing the CSV file

  1. Log in to the Microsoft 365 admin center (https://admin.microsoft.com) with the credentials of your source tenant administrator.
  2. From the navigation pane, click Active groups.
  3. Select Microsoft 365 tab in the Active Groups page
  4. Set the list filter to Groups with Teams.
  5. Click Export and then click Export groups in this list. A Groups.csv file will be downloaded to your computer.

  6. Edit the CSV file and retain the Group ID and Group name columns. Then retain the teams you want to discover and delete the rest. If you retain a row that references a group without a team, the group will be ignored during discovery.

    NOTE:

    • You can download a CSV template when you start the New Teams Discovery Task wizard and click Download Example File from the Discovery Options step.
    • CSV file names with non-ASCII characters are not supported.

  7. Save the CSV file. You may rename the file if needed.

Starting the Discover Teams Task

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migrate > Projects to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click Teams from the project tiles, or click Open from the Teams tile to open the Teams dashboard.
  5. Click the Teams tab and select the List View if not already selected. Then click Discover Teams > Discover From File from the Actions menu.
  6. The New Teams Discovery Task wizard starts. Each step is described below:
  7. 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.
  8. 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.
  9. 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.
  10. 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 Teams.
      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 Teams Task

  1. Open the Tasks tab.
  2. Select the task that you want to review. The default name is Discover Teams.
  3. 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.
 

Reviewing the Discover Teams Task Events

  1. Open the Tasks tab.
  2. Select the task that you want to review.
  3. In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
  4. 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 Teams with Collections

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

In this topic:

Adding Teams to Collections

You can add teams to collections in several ways:

To add selected teams to a new collection:

  1. From the project dashboard, click Open in the Teams tile to open the Teams dashboard.
  2. Click the Teams tab and select List View if not already selected.
  3. Select the teams you want to add to the collection.
  4. From the actions toolbar, click Collections > New Collection. The New Collection dialog opens.

  5. Enter a collection name in the Collection name field and click Save to add the selected teams to the collection.

To add selected teams to an existing collection:

  1. From the project dashboard, click Open in the Teams tile to open the Teams dashboard.
  2. Click the Teams tab and select List View if not already selected.
  3. Select the teams you want to add to an existing collection.
  4. From the actions toolbar, click Collections > Add To Collection. The Add to existing collection dialog opens.

  5. Select a collection from the Collection name dropdown and click Save to add the selected teams to the collection.

To add teams from a CSV file to a new or existing collection:

Using a CSV file provides the following additional benefits:

  • Multiple collections can be created with the same CSV file.
  • Existing collections can be specified in the CSV file to add additional teams.
  • Public Folders can be listed in multiple collections.

This is a two-step process as described below to add teams to one or more collections:

Step 1: Prepare the CSV file

  1. From the actions toolbar, click Collections > Import Collections. The New Import Collections from File Task wizard starts.
  2. From the Mapping File step, click Download Example File. A ZIP file is downloaded.
  3. Extract the CSV file and use it to prepare your import file in one of three formats described below:

    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 teams 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. If a collection in the CSV does not exist, a new collection will be created with the name specified in the CSV.
    • Source MailNickname - Email alias of the M365 group of the team. You can get the Source MailNickname property of the teams when you export teams to a CSV file. Source MailNickname values are case-sensitive.

Step 2: Import the CSV file

  1. Open the Teams tab.
  2. From the actions toolbar, click Collections > Import Collections. The New Import Collections from File Task wizard starts.
  3. Mapping File
    1. Click Browse and select the CSV file. The selected CSV file name appears.
  4. Schedule
    1. Choose from one of three options to schedule the task. The scheduler will be activated 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.
  5. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Import Collections From File. You can specify a custom name.
      2. 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.
    3. Click Finish.

To verify the addition of the team to a collection:

  1. Check the Collections column in the Teams List View that indicates the most recent collection where the team has been added and the number of additional collections that also contain the team.
  2. Select a team from the Teams List View to open the Team Detail pane. Check the Collections property that lists all the collections where the team has been added.

Working with the Collections Dashboard

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

To view the collection dashboard for an existing collection:

  1. From the project dashboard, click Open in the Teams tile to open the Teams workspace.
  2. From the top-right corner of the workspace, click Select Collection and then select the collection to view. The collection Dashboard is displayed.
  3. Open the Teams tab. You will see the list of teams that belong to the collection.

To remove items from a collection:

  1. From the actions toolbar, click Collections > Remove from Collection.
  2. In the confirmation dialog click Remove to remove the selected Teams from the collection.

To rename the collection:

  1. Click Collections > Rename Collection in the Actions toolbar of the collections dashboard.

To delete the collection:

  1. Click Collections > Delete Collection in the Actions toolbar of the collections dashboard.

To see the tasks for collection-specific teams:

  1. Open the Tasks tab.

To see the events related to the collection:

  1. Open the Events tab.

To return to the Teams migration workspace:

  1. Click the collection dropdown at the top-right corner of the page, and select Show All.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating