Chat now with support
Chat with Support

On Demand Migration Current - Administrator Guide

About On Demand Migration Before You Start Working with On Demand Migrations Starting Migration Project Configuring Connections Sharing Availability Information Collecting Account Information Pre-Migration Assessment Account Migration Domain Coexistence Mail Migration OneDrive Migration Resource Processing Public Folders Migration SharePoint Online Migration Microsoft Teams Migration Finalizing the Migration

Matching Accounts

Your target tenant might already contain accounts created for the source tenant users before the migration. You can map them to the corresponding source accounts, so that no data is lost or duplicated. Create Matching Task:

  1. Open Accounts.
  2. Select the accounts you want to match and click Match Accounts.

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

  1. By default, you are matching the accounts using the attribute value. For example, identical display name or email address. You can also create more complex matching rules, for example using different attributes on source and target. Click Next to proceed.
  2. Schedule when the task will be started. See Task Scheduling for details. Click Next to view the task summary.
  3. Check the matching rule, scheduled start of the task and name the task. Click Finish to save or start the task depending on schedule option selected.

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

Using the Manual Mapping

In some cases, the matching accounts attributes may differ. For example, it might happen when you have created some of the accounts manually as a part of initial migration to the new tenant. To handle such environments, you can provide a file with the custom mapping between source and target accounts.

  1. Prepare a comma-separated values (CSV) file with the matched account pairs. The first row defines the names of the source and target attribute used for mapping. Subsequent rows list the matching values of the attributes (one pair per row.) For example:

<sourceAttributeName>,<targetAttributeName>

john.doe@source.domain,jdoe@target.domain

jane.roe@source.domain,jane@target.domain

NOTES:
  • Supported source attributes: userPrincipalName, objectId.
  • File names with non-ASCII characters are not supported.
  1. Open Accounts and click Map from File. Do not select any accounts from the list – you have already specified them in the file created on Step 1.
  2. Click Browse to open the mapping file created on Step 1.
  3. Browse for file and click Open. Selected file name appears next to the Browse button.
  1. Schedule when the task will be started. See Task Scheduling for details. Click Next to view task summary.
  2. Check selected options. Click Finish to save or start the task depending on schedule option selected.

The task is created. You can track the progress in the Tasks list or view the summary on the Dashboard.

NOTE:

  • The account pairs that do not exist in the source and/or target tenants as well as the source accounts that are not enumerated during the Discovery are ignored without producing an event.
  • If you import the mapping from file, an active collection, selected accounts, search, and filters are ignored. The matching is always performed for all pairs provided in the file.

Clearing the Matches

In some cases, you might want to remove the mapping for individual accounts. It might happen when fixing the result of erroneous matching or fine-tuning the outcome of a previous task. To clear unwanted matches, create a special matching task.

  1. Open Accounts and select the items for which you want to remove the mapping.
  2. Click Match Accounts and select Clear existing matches option. Click Next to proceed.
  3. Schedule when the task will be started. See Task Scheduling for details. Click Next to view task summary.
  4. Name the task and check selected options. Click Finish to save or start the task depending on schedule option selected.

NOTE: Once the task is complete, the matched accounts will revert to the New status and the matching is cleared for selected pairs.

You can see a task status on the Tasks screen. For more information refer to details panel in the bottom of the screen.

Migrating Accounts

Caution: Don’t start the migration before the discovery task is finished.

When the matching is done, it is time to migrate source accounts that do not have the pairs on the target tenant. Create a new migration task:

  1. Open Accounts.
  2. Select accounts you want to migrate.

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

  1. Click Migrate Accounts and provide vanity domain name instead of default *.onmicrosoft.com. Typically it is a domain name of your organization.

IMPORTANT: The custom domain name must be set up on the target tenant. See Quickstart: Add a custom domain name to Azure Active Directory for details.

  1. Click Next to proceed.
  2. Schedule when the task will be started. See Task Scheduling for details. Click Next to view the task summary.
  3. Check selected options and name the task. Click Finish to save or start the task depending on schedule option selected.

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

Related Documents