Manage migration batches in Exchange Online

 

Applies to: Exchange Online

You can use the Migration dashboard in the Exchange admin center (EAC) to manage mailbox migration to Exchange Online using a cutover or staged Exchange migration. You can also use the Migration dashboard to migrate the contents of users’ mailboxes from an on-premises IMAP server to existing Exchange Online mailboxes. The Migration dashboard displays statistics about the overall migration in addition to statistics about a specific migration batch. You can create, start, stop, pause, and edit migration batches.

Contents

  • The Migration dashboard

  • Overall migration statistics

  • Migration batches

  • Migration batch statistics

The Migration dashboard

To access the Migration dashboard in the EAC, select Recipients > Migration. The following screen shot identifies the different areas of the Migration dashboard that you can use to get migration information and manage migration batches.

Migration dashboard

Overall migration statistics

Click Status for all batches to display the overall statistics about all migration batches that have been created. The following fields display cumulative information about all migration batches.

Field Description

Total mailboxes

The total number of mailboxes from all current migration batches.

Synced mailboxes

The number of mailboxes from all migration batches that were successfully migrated.

Finalized mailboxes

The number of mailboxes from all migration batches that have been finalized. Finalization only occurs when using remote move migrations to migrate mailboxes between your on-premises Exchange organization and Exchange Online in an Exchange hybrid deployment. Mailboxes can be finalized after the initial synchronization is successfully completed. For more information about finalizations in remote move migrations, see Complete-MigrationBatch.

Failed mailboxes

The number of mailboxes from all migration batches for which migration failed.

Return to top

Migration batches

Migration batches that are created are listed in the migration queue. The following columns display information about each migration batch.

Column Description

Name

The name of the migration batch that was defined when the migration batch was created.

Status

The status of the migration batch. The following is a list of the different status states for migration batches, along with what you can do with migration batches in each of these states:

  • Created: The migration batch has been created, but it hasn't been started. In this state, you can start, edit, or delete it.

  • Syncing: The migration batch has been started, and mailboxes in the migration batch are being actively migrated. When a migration batch is in this state, you can stop it.

  • Stopped: The migration batch is stopped, and no more mailboxes from the batch are being migrated. When a migration batch is in this state, you can restart it.

  • Synced: The migration batch has completed, and no mailboxes are being actively migrated. A migration batch in this state may contain errors if mailboxes weren’t migrated. For cutover Exchange migrations and IMAP migrations with this status, on-premises mailboxes and the corresponding Exchange Online mailboxes are synchronized every 24 hours during incremental synchronization.

  • Synced with errors: The migration batch has completed, but some mailboxes failed migration. Mailboxes that were successfully migrated in migration batches with errors are still synchronized every 24 hours during incremental synchronization.

Total

Indicates the number of mailboxes in the migration batch.

Synced

Indicates the number of mailboxes that were successfully migrated.

Finalized

The number of mailboxes in the migration batch that have been finalized. Finalization is only performed for migration batches for remote move migrations in an Exchange hybrid deployment. For more information about the finalization process, see Complete-MigrationBatch.

Failed

The number of mailboxes in the migration batch for which migration failed. You can display information about specific mailboxes that have migration errors. For more information, see Migration users status report.

Important

Migration batches with a status of Synced that have no administrator-initiated activity (for example, no administrator has stopped and restarted a migration batch or edited a migration batch) for the last 60 days will be stopped, and then deleted 30 days later if no further action is taken by the administrator.

The Migration dashboard contains a set of commands that you can use to manage migration batches. After you create a migration batch, you can select it and then click one of the following commands. If a migration batch is in a status state that isn’t supported by a command, the command is either dimmed or not displayed because it’s unavailable.

Command Description

New Add Icon

Create a migration batch. Use this command to migrate on-premises mailboxes to Exchange Online (also called onboarding) or to migrate Exchange Online mailboxes back to your on-premises Exchange organization in a hybrid deployment.

Edit Edit icon

Edit an existing migration batch. For staged Exchange migrations and IMAP migrations, you can submit a different CSV file. You can also change the migration endpoint used for the migration batch. You can only edit a migration batch that has a status of Created.

Start Start Icon

Start a migration batch that’s been created. After the batch is started, the status is changed to Syncing.

Resume Start Icon

Resume the running of a migration batch that was paused and has a status of Stopped. If there are errors for a migration batch, you can restart it with this command and Exchange Online will attempt to migrate the mailboxes that failed.

Pause Stop Icon

Stop a migration batch that’s currently running or that’s been started but has a status of Queued. You can also stop a cutover Exchange migration batch or an IMAP migration batch that’s completed the initiation synchronization phase and has a status of Synced. This will stop incremental synchronizations. You can resume incremental synchronizations by selecting the migration batch and clicking Resume.

Delete Delete icon

Delete a migration batch after you verify that all mailboxes in the migration batch have been successfully migrated and that mail is being routed directly to cloud-based mailboxes after you’ve configured your MX record to point to Office 365. When you delete a migration batch, Exchange Online cleans up any records related to the migration batch and removes it from the list.

More More Options Icon

Click this command and then click Migration endpoints to create migration endpoints or view and edit existing migration endpoints. For more information, see Create migration endpoints.

Refresh Refresh Icon

Refresh the Migration dashboard to update the information displayed for the overall migration statistics, the list of migration batches, and the statistics for the selected migration batch.

SyncNow SyncNow

Trigger an immediate sync for users who have already reached Synced status. However, this command does not resume any Failed users. For Onboarding moves, it can be used just before Completion to speed up that step. For IMAP migrations, it can be used just after MX record switchover.

Return to top

Migration batch statistics

The details pane in the Migration dashboard displays the following information about the selected migration batch.

Field Description

Type

Indicates the migration type of the selected migration batch. The value of this field also denotes the type of migration endpoint associated with the migration batch.

  • Exchange Outlook Anywhere: The migration batch is either a cutover Exchange migration or a staged Exchange migration.

  • IMAP: The migration batch is an IMAP migration.

  • Remote move migration: The migration batch is either an onboarding or offboarding remote move migration in an Exchange hybrid deployment.

Direction

Indicates if mailboxes are being migrated to Exchange Online or to your on-premises Exchange organization.

  • Onboarding indicates that mailboxes are being migrated to Exchange Online. Onboarding migration types are staged migrations, cutover migrations, IMAP migrations, and onboarding remote move migrations.

  • Offboarding indicates that Exchange Online mailboxes are being migrated to your on-premises Exchange organization. Offboarding remote move migrations are the only type of offboarding migration.

Status

The current state of the selected migration batch.

  • Created

  • Syncing

  • Stopped

  • Synced

  • Synced with errors

See the previous description of each of these states.

Requested

The number of mailboxes to be migrated in the migration batch. This number corresponds to the number of rows in the migration CSV file for IMAP, staged, or remote move migrations, or the number of on-premises mailboxes in a cutover Exchange migration.

Synced mailboxes

The number of mailboxes out of the total number in the migration batch that have successfully completed initial synchronization. This field is updated during the migration.

Finalized

The number of mailboxes out of the total number in the migration batch that have successfully been finalized. Finalization only occurs in onboarding and offboarding remote move migrations.

Failed mailboxes

The number of mailboxes that failed initial synchronization.

View details

Click View details to display status information for each mailbox in the migration batch. For more information, see Migration users status report.

Created by

The email address of the Exchange Online administrator who created the migration batch.

Create time

The date and time when the migration batch was created.

Start time

The date and time when the migration batch was started.

Initial sync time

The date and time when the migration batch completed initial synchronization.

Initial sync duration

The amount of time it took to complete the initial synchronization for all mailboxes in the migration batch.

Last sync time

The last time the migration batch was restarted or the last time that incremental synchronization was performed for the batch. As previously stated, incremental synchronization occurs every 24 hours for IMAP migrations and cutover Exchange migrations.

Associated endpoint

The name of the migration endpoint being used by the migration batch. You can click View details to view the migration endpoint settings. You can also edit the settings if none of the migration batches using the endpoint are currently running.

Return to top