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

Collecting Statistics

A Collect Account Statistics Task conducts an assessment of all accounts in the source tenant and matching accounts in the target tenant.

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

NOTE: Before you proceed, verify that the source tenant accounts have been discovered. For more information see Discovering Accounts

In this topic:

Create a Collect Account Statistics Task

  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 Account tile, or click Open from the Account tile to open the Accounts and User Data migration workspace.
  5. Select the Accounts tab and then select List View if not already selected. Then select any account in the list to activate the menu options.
  6. From the Actions menu, click More> Collect Statistics. The New Collect Account Statistics Task wizard starts. Each step is described below:
  7. Description
    1. Retrieve external sender permissions for distribution groups - retrieves the permissions set for external users who are allowed to send email to distribution groups.
    2. Collect statistics from target - select this option to collect statistics from the target tenant and generate the Comparison Report.
    3. Retrieve group membership details - select this option to retrieve group memberships of group type accounts.
    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 Collect Account Statistics Task.
      2. Source tenant - name of the tenant where the statistics will be collected.
      3. 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 Collect Account Statistics Task

  1. Open the Tasks tab.
  2. Select the Collect Account Statistics 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 Account Assessment.
    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 - 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) - number of accounts processed and their task status.
    8. Events (number) - number of events that the task encountered.

Review the statistics collected

  1. Open the Tasks tab.
  2. Select the Collect Account Statistics Task that you want to review.
  3. From the task details pane, click Download Premigration Report. If comparison reports were generated, click Download comparison report.
  4. 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
  • Discover From Security Groups
  • Refresh Selected Accounts

Review the Collect Account Statistics Task Events

  1. Open the Tasks tab.
  2. Select a task named Collect Account Statistics 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 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. the value is Account Assessment.

Assessment

The On Demand Migration account service analyzes your domain structure and tracks potential problems, misconfiguration, and risks that might adversely affect the migration. Switch to Assessment view to see the summary reports about the discovered data.

The following reports are available for Accounts:

  • Clean Up
    • Disabled accounts
    • Users with non expiring passwords
  • Adjustments
    • Duplicate group names
    • Duplicate user names
    • Users without first name
    • Users without last name
  • Inventory
    • Number of users
    • Number of groups
  • User by Type
    • External Accounts
    • Tenant members
  • Licenses
    • Available ODM licenses
    • Used ODM licenses
    • Available Teams only licenses
    • Used Teams only licenses

 

Migrating Accounts

Caution: Don’t start a migration before the discovery task is finished. Running a matching task is recommended.

In this topic:

Considerations for Guest User Migration

TIP: Guest user accounts have a specific icon to distinguish them from other domain members.

On Demand migration can process all guest user types supported by Microsoft. Before adding a guest user account to the migration task, consider the following:

  • Guest user account cannot be migrated if an original account for this guest user is already in the target tenant. The guest user account should be matched but not migrated.
  • Guest user account cannot be migrated in case a guest user account of the same original account is already in the target tenant. To update the target guest user account properties create a matching task to pair these guest user accounts and then migrate the source guest user account again
  • Guest user account cannot be migrated in case the invitation procedure in source domain is not finished yet. In case acceptance procedure was skipped (this case is deprecated now, but such guest users still exist), and the acceptance status is empty, guest user can be migrated successfully.
  • A regular source user mapped to a target guest user during migration, will be converted to a regular user. If the target guest user was created in an on-premise environment, you must manually convert the target guest user to a regular user.

Preferred Data Location

For multi-geo enabled tenants, each account could be assigned a Preferred Data Location (PDL) property in Azure Active Directory. During account migration the property is migrated from source to target tenant. If the preferred data location is set in the source account then the same setting can be migrated to the target. If the preferred data location is absent in the source tenant then it will either not be set on the target or it will use the default location of the target tenant. This applies only for general tenant to multi-geo tenant and multi-geo tenant to multi-geo tenant migrations.

Starting an Account Migration Task

  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. Click the Accounts tab and select List View if not already selected.
  6. Select the accounts you want to migrate. If you are planning to migrate Microsoft 365 Groups including content, see Microsoft 365 Groups Migration.
  7. Click Migrate from the Actions menu. The New Account Migration Task wizard starts. Each step is described below:
  8. Custom Target Domain

    1. Configure the options as described below:
      • Custom target domain name - select the domain you want to use for the UPN and primary SMTP address of accounts created during the migration process.

        NOTE: Accounts that already exist in the target tenant will not have their current UPN or primary SMTP email address modified.

      • Set target PDL - choose how the Preferred Data Location (PDL) will be assigned to target accounts created in multi-geo tenants. This applies only for general tenant to multi-geo tenant and multi-geo tenant to multi-geo tenant migrations. The Microsoft 365 multi-geo feature must be available and enabled in the target tenant, otherwise this option is ignored.
        • Migrate PDL value from source account - assign the same PDL value as the corresponding source account, or use the default location specified in the target tenant.
        • Select PDL value to assign - assign a specific PDL value to target accounts. Choose a PDL from the Location dropdown. See Microsoft 365 Multi-Geo availability for location codes.
    2. Click Next.
  9. Custom Source Domain
    1. Configure the setting as described below:
      • Custom source domain for routing - select the custom source domain name for forwarding mail from the target account. If the domain is omitted, the primary SMTP address of the source tenant will be used as the forwarding address for the mail enabled user created by this task. Optionally, you can select the custom SMTP domain here that will be used as the forwarding address.
    2. Click Next.
  10. Guest Users

    This option is used when guest users are migrated. For all other account types, this option is ignored.

    Send invitation email - select this option to send an invitation email to migrated guest users. Guest users can either accept the invitation or authenticate with Microsoft to access secured applications. If this option is not selected, guest users must authenticate with Microsoft to access secured applications.

  11. 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.
  12. 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.
  13. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. You can specify a custom name. Default name is Account Migration Task.
      2. Source tenant - name of the source tenant in this project.
      3. Target tenant - name of the target tenant in this project.
      4. Custom target domain name - domain name of your target tenant.
      5. Custom domain for forwarding - custom source domain or primary SMTP address of the source tenant used as the forwarding address for the mail enabled user created by this task.
      6. 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.

You can track its progress in the Tasks tab, view the summary on the Dashboard or monitor alerts and notifications in the Events tab. When accounts are matched successfully, the Status changes from New to Completed.

IMPORTANT: The account migration service does not synchronize end-user passwords as part of the data migration process. The migration administrator will need to reset or synchronize end-user passwords from the source tenant to the target tenant using native Microsoft 365 tools or third-party Single Sign On tools.

Reviewing the Account Migration 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 Migration.
    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 from Migrating to Migrated.
    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 Migration 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 event 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 migration tasks, the category is Migrate.
    5. Summary - a descriptive statement about the event.

Migrating Group Membership

You can migrate group members with the Group Membership Migration Task for Distribution Groups, Security Groups, and Mail-Enabled Security Groups. Teams and M365 groups are not supported by Group Membership Migration Task.

  • Membership is migrated for all group members that have been matched.
  • Unmatched members will be skipped.
  • Matched accounts in the target tenant are appended to the target group.
  • Existing group members in the target tenant are not removed.

Starting the Group Membership Migration Task

  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. Select Distribution Groups, Security Groups, and Mail-Enabled Security Groups from the list.
  7. From the actions toolbar, click More > Migrate Group Membership. The New Migrate Group Membership Task wizard starts. Each step is described below:
  8. Description
    1. Read the description to understand the implications of group membership migration.
    2. Click Next.
  9. 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.
  10. 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.
  11. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. You can specify a custom name. Default name is Group Membership Migration Task.
      2. Source tenant - name of the source tenant in this project.
      3. Target tenant - name of the target tenant in this project.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Reviewing the Group Membership Migration Task

You can track a task's progress from the Tasks tab, view the summary on the Dashboard or monitor alerts and notifications in Events.

You can track the migration state from the Account State column in the Accounts list view. The column values during and after a task is run are as follows:

Column value Description
Migrating

Migration of this object has started.

  • For each source member object (user or group), the matched target account is added to the matched target group
  • If the matched target account is already a member in the group, the member will not ne processed.
Migrated Migration is complete and successful. Matches were found for all source group members and the target members were added to the target group.
Migrated with Issues

Migration has completed with errors. At least one member was migrated, but not all. Possible reasons:

  • Source member did not matched a target account. Runthe Account Matching Task or Account Mapping Task for this member, or ignore if the member is not in scope.
  • Source member was matched to a target account, but an error occurred when trying to add the member to the target group. The member that failed is listed in the task event. Review error details.
Migration failed

Migration of members did not succeed. Possible reasons:

  • Source group did not match a target group. Run the Account Matching Task or Account Mapping Task, or perform a standard Account migration.
  • Selected object was a User, Team, or M365 Group. Group Membership migration is not supported for these objects.
  • An error occurred that prevented migrating any members to the matched target group. Review error details.
Migration stopped Migration canceled by the user.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating