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

Discovering Accounts

Discovering accounts is a critical first step before a migration to enumerate, update and retrieve relevant information about accounts from the source tenant. The discovery task collects the necessary account data and statistics on connected mailboxes from your source tenant to avoid misconfiguration and prevent possible issues.

NOTE: Account discovery is deactivated if basic migration consents are missing from either the source or the target tenant.

If there are user or group accounts from a previous discovery task that you don't want anymore, you can manually delete the accounts from the Accounts list (Accounts tab > List View). If there are changes to an account from a previous discovery, the account will be updated if the account is rediscovered by the task.

 

In this topic:

 

Discovering all accounts automatically

  1. Log in to Quest On Demand and choose an organization if you have set up 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 Accounts tile on the project dashboard click Open. The Accounts and User Data migration workspace opens.
  5. Open the Accounts tab . From the List View menu, click Discovery and then select Discover All. The New Account Discovery Task wizard starts.
  6. 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.
  7. 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.
  1. Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. You can specify a custom name. Default name is Account Discovery Task.
      • Source tenant - name of the source tenant in this project.
      • Discover Type - discovery option that is selected. Value is set to All.
      • 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. The task will start as scheduled.

The migration 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. When the discovery task is complete, a summary about the accounts discovered in the source tenant is available on the project dashboard.

Discovering accounts from a file

When you have a large set of accounts but you want to discover a subset of those accounts, the CSV file lets you specify the accounts (users and Microsoft 365 groups) that you want to discover and ignore the rest. You can then use this file in the New Account Discovery Task wizard.

To prepare 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. Export Users:
    1. From the navigation pane, click Active users.
    2. If needed, you can filter the set of users that you want to export. Then click Export. A Users_<timestamp>.csv file will be downloaded to your computer.
  3. Export Groups:
    1. From the navigation pane, click Active teams and groups.
    2. Select the Microsoft 365 tab in the Active teams and groups page.
    3. If needed, you can filter the set of groups that you want to export. Click Export and then click Export groups in this list. A Groups.csv file will be downloaded to your computer.

  4. Create a new CSV file and add the user accounts and groups with accounts you want to discover. You can use any of the two formats shown below:

    NOTE:

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

    Format 1

    UserPrincipalName - Column header for the login name for a user account based on the Internet standard RFC 822. Do not use a mail nickname or proxy address.

    Format 2

    ObjectId - Column header for the globally unique identifier (GUID) of the user or group object. When you use ObjectId as the column header, you must specify object GUIDs only. You cannot specify UPNs.

    Type - Column header for the type of account: user or Microsoft 365 group.

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

To run the account discovery task:

  1. Log in to Quest On Demand and choose an organization if you have set up 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 Accounts tile on the project dashboard click Open. The Accounts and User data migration workspace opens.
  5. Open the Accounts tab . From the List View menu, click Discovery and then select Discover From File. The New Account Discovery Taskwizard starts.
  6. Discovery Options

    1. Click Browse to choose the comma-separated values (CSV) file that contains the lists of user accounts and group identifiers.
    2. Click Next.
  7. 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.
  8. 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.
  1. Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. You can specify a custom name. Default name is Account Discovery Task.
      • Source tenant - name of the source tenant in this project.
      • Discover Type - discovery option that is selected. Value is set to Using CSV file.
      • 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. The task will start as scheduled.

The migration 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. When the discovery task is complete, a summary about the accounts discovered in the source tenant is available on the project dashboard.

Discovering accounts from a file using security groups

When you need to limit an application's access to a specific set of mailboxes, use this option to include the security groups in a CSV file. You can then use this file in the New Discovery Task as described in this topic to discover the accounts from the source tenant. Application access policies can be assigned to these discovered groups to restrict access to the group members only.

To prepare 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. Export Security Groups:
    1. From the navigation pane, click Teams and groups.
    2. Select the Mail-enabled security tab in the Active teams and groups page.
    3. If needed, you can filter the set of groups that you want to export. Click Export and then click Export groups in this list. A Groups.csv file will be downloaded to your computer.

  3. Create a new CSV file and add the email ids of the security groups with the member accounts you want to discover.

    NOTE:

    • You can download a CSV template when you select Discover From Security Groups and start the New Account Discovery Task wizard.
    • CSV file names with non-ASCII characters are not supported.

    MailEnabledSecurityGroupEmailID - Column header for email IDs of the security groups.

  4. Save the CSV file that you created.

To run the account discovery task:

  1. Log in to Quest On Demand and choose an organization if you have set up 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 Accounts tile on the project dashboard click Open. The Accounts and User data migration workspace opens.
  5. Open the Accounts tab . From the List View menu, click Discovery and then select Discover From Security Groups. The New Account Discovery Taskwizard starts.
  6. Discovery Options

    1. Click Browse to choose the comma-separated values (CSV) file that contains the list of email IDs of the security groups.
    2. Create application access policy for provided groups - select this option to create an application access policy for groups when it is necessary to restrict access to group members only, when migrating account mailboxes . The new application access policy can take up to 30 minutes to take effect on Azure groups. For more information see Limiting application permissions to specific Exchange Online mailboxes.
    3. Click Next.
  7. 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.
  8. 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.
  1. Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. You can specify a custom name. Default name is Account Discovery Task.
      • Source tenant - name of the source tenant in this project.
      • Discover Type - discovery option that is selected. Value is set to Using Mail-enabled Security Group(s).
      • 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. The task will start as scheduled.

The migration 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. When the discovery task is complete, a summary about the accounts discovered in the source tenant is available on the project dashboard.

Refreshing Selected Accounts

For all source and target accounts , the task will refresh the UPN, Primary Email Address and Object Type of selected accounts. The task will not modify the migration state of the accounts.

To start the refresh task:

  1. Log in to Quest On Demand and choose an organization if you have set up 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 Accounts tile on the project dashboard click Open. The Accounts and User data migration workspace opens.
  5. Open the Accounts tab . From the List View menu, click Discovery and then select Refresh Selected Accounts. The New Refresh Selected Accounts Task wizard starts.
  6. 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.
  7. 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.
  8. Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. You can specify a custom name. Default name is Refresh Selected Accounts Task.
      • Source tenant - name of the source tenant in this project.
      • Discover Type - discovery option that is selected. Value is set to Refresh Selected.
      • 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. The task will start as scheduled.

Reviewing the Account Discovery Task

  1. Open the Tasks tab.
  2. Select the account discovery task that you want to review.
  3. In the task details pane that opens, the information presented is as described below:
    1. Type - Type of the task. The type is Discovery Task.
    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. Accounts (number) - The number of accounts that were selected for matching and the number of accounts passing through the various states of the task from New to Completed..
    8. 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 Account Discovery Task Events

  1. Open the Tasks tab.
  2. Select the account discovery task for which you want to review the events.
  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 task details pane that opens, the information presented is as described below:
    1. Object - name of the account object if applicable.
    2. Task - name of the task.
    3. Time - date and time when the event occurred.
    4. Category - type of task. For account discovery tasks, the category is Discover.
    5. Summary - a descriptive statement about the event.

You are now ready for the Premigration Assessment.

Exporting Accounts

  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. Click the Accounts tile, or click Open from the Accounts tile to open the Accounts and User Data dashboard.
  5. Select the Accounts tab and select List View if not already selected.
  6. Select the accounts to export.
  7. Click More > Export.

  8. Open the CSV file by extracting it from the ZIP file that is downloaded to your computer.

Removing Accounts

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

If these accounts are listed in other projects, they will be displayed in those projects.

  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. Click the Accounts tile, or click Open from the Accounts tile to open the Accounts and User Data dashboard.
  5. Select the Accounts tab and select List View if not already selected.
  6. Select the accounts you want to clear.

    TIP: Use filters, search or collections to quickly navigate through the list of accounts.

  7. Click More > Delete.

  8. The Remove Objects confirmation dialog opens.

  9. Click Remove to remove the selected accounts from the list.

Managing Accounts with Collections

Migrating large numbers of accounts requires careful planning. The accounts could belong to different offices and geographical locations or sensitive departments. Migrating groups of employees in top management, Finance or Legal departments require special care. Organize the accounts into collections to make large account lists more manageable.

Working with the Collection Dashboard

The Collection Dashboard shows the collection-specific summary, allows you to see accounts 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 Accounts tile to open the Accounts and User Data 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 Browse Accounts from the collection Dashboard menu or open the Accounts tab. You will see the list of accounts that belong to the collection.

  • To see the tasks for collection-specific account objects, open the Tasks tab.
  • To see the events related to the collection, open the Events tab.
  • To rename the collection, click Rename Collection in the Actions toolbar of the collections dashboard.
  • To delete the collection, click Delete Collection in the Actions toolbar of the collections dashboard.
  • To return to the Account migration workspace, click the collection dropdown at the top-right corner of the page, and select Show All.

Adding accounts to Collections

You can add accounts to collections in three ways:

To add selected accounts to a new collection:

  1. From the project dashboard, click Open in the Accounts tile to open the Accounts and User Data migration workspace.
  2. Open the Accounts tab and select List View if not already selected.
  3. Select the accounts you want to add to a collection.
  4. From the actions toolbar, click New Collection. The New Collection dialog opens.

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

To add selected accounts to an existing collection:

  1. From the project dashboard, click Open in the Accounts tile to open the Accounts and User Data migration workspace.
  2. 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.
  3. Click the Accounts tab and select the accounts that you want to add to the collection.
  4. From the actions toolbar, click Add to Collection. The Add to existing collection dialog opens.

  5. Select your collection from the Collection name dropdown and click Save to add the selected accounts to the collection.

To create one or more collections with a CSV file:

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 accounts
  • Accounts can be listed in multiple collections

This is a two-step process as described below:

Step 1: Prepare the CSV file

NOTE: You can download a CSV template for either of the two formats when you click More > Import Collections to open the Import Collections from File dialog.

You can choose one of two formats to prepare the CSV file:

Format 1: Use the ObjectId to identify accounts

  • ObjectId - Column header for the globally unique identifier that represents a discovered account. The following variations of ObjectId are supported: ObjectId, objectid, objectId, OBJECTID
  • Collection - Column header for the collection name

Format 2: Use the UserPrincipalName to identify accounts

  • UserPrincipalName - Column header for the login name of an account based on the Internet standard RFC 822. Do not use a mail nickname or proxy address. The following variations of UserPrincipalName are supported: UserPrincipalName, userprincipalname, USERPRINCIPALNAME
  • Collection - Column header for the collection name

Import the CSV file

  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. Click the Accounts tile, or click Open from the Accounts tile to open the Accounts and User Data migration workspace.
  5. Select the Accounts tab and select List View if not already selected.
  6. From the actions toolbar, click More > Import Collections. The Import Collections from File dialog opens.

  7. Click the Provide accounts as a list of drop-down and select either ObjectIds or UserPrincipalNames depending on the format of the CSV file that you have prepared.
  8. Click Browse and select the CSV file. The selected CSV file name appears.
  9. Click Import.

NOTE: Identifiers of accounts that are not discovered are ignored without producing an event.

To verify the addition of the account to a collection:

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

Removing Accounts from Collections

  1. From the project dashboard, click Open in the Accounts tile to open the Accounts migration workspace.
  2. From the top-right corner of the migration workspace, click Select Collection. Then select a collection to open the collections dashboard.
  3. From the list view, select the accounts that you want to remove from the collection.
  4. From the actions toolbar, click Remove from Collection.
  5. In the confirmation dialog click Remove to remove the selected accounts from the collection.
  6. To return to the Accounts migration workspace, 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