Migrating to to Exchange or Office 365 using impersonation

Office 365:

MigrationWiz uses delegation by default to log in to individual user mailboxes using administrative credentials specified on the connector. However, MigrationWiz also supports impersonation in specific environments.

Benefits:

Using impersonation, sharing the throttling quota and connection limits associated with a single administrative account stops. Instead, the throttling quota of each user is used for each user mailbox.

Using impersonation:

  • Eliminates most "Connection did not succeed" errors.
  • Allows migration of more mailboxes concurrently.
  • Reduces the impact of throttling and connection limits.
  • Uses an administrator account without assigning a license to it.

Steps:

To migrate using impersonation:

  • Use admin credentials at the Destination.
  • Sign in to the MigrationWiz account.​
  • Edit the Project and click on Advanced Options.
  • If migrating from Office 365, under Source, check Use impersonation to authenticate.
  • If migrating to Office 365, under Destination, check Use impersonation to authenticate.
  • Click on Save Options.

MigrationWiz will automatically run a remote PowerShell command to allow the admin account to log in to (impersonate) user mailboxes.

Here is the remote PowerShell command we execute when a mailbox has been submitted for migration:

Enable-OrganizationCustomization

New-ManagementRoleAssignment -Role ApplicationImpersonation -User <admin_user_name>

To learn how to run these commands manually, click here. This is useful if there are delays from Microsoft and the Powershell command does not run immediately.

Exchange 2010+:

MigrationWiz uses delegation by default to log in to individual user mailboxes using administrative credentials specified on the connector. However, MigrationWiz also supports impersonation in specific environments.

Benefits:

Using impersonation, sharing the throttling quota and connection limits associated with a single administrative account stops. Instead, the throttling quota of each user is used for each user mailbox.

Using impersonation:

  • Eliminates most "Connection did not succeed" errors.
  • Allows migration of more mailboxes concurrently.
  • Reduces the impact of throttling and connection limits.

Steps:

To migrate using impersonation:

  • Use admin credentials at the Destination.
  • Sign in to the MigrationWiz account.
  • Edit the Project and click on Advanced Options.
  • Under Destination, check Use impersonation to authenticate.
  • If migrating from Exchange 2010+, under Source, check Use impersonation to authenticate.
  • If migrating to Exchange 2010+, under Destination, check Use impersonation to authenticate.
  • Click on Save Options.

For Exchange migrations, to enable the admin account to impersonate users, run this PowerShell command:

New-ManagementRoleAssignment -Role ApplicationImpersonation -User <admin_user_name>

More information about this PowerShell command can be found here.

Office 365 plans named "Business Essential" and "Business Premium" do support impersonation. Follow the steps above, under the Office 365 section, to enable support for use of impersonation when migrating from or to "Business Essential" or "Business Premium".

If the above Advanced Options are set to use impersonation on a project, these settings will only become effective for those migrations that are started after saving the settings. Migrations that are already running will be unaffected by any such changes.

Was this article helpful?
5 out of 8 found this helpful