Important
If you start your migration using EWS (Microsoft 365) or Graph (Microsoft 365 Graph API) endpoints as a source and/or destination, and you decide to switch the migration endpoint type (Example: from EWS to Graph or vice versa) before the migration is completed (this is not recommended unless absolutely necessary), you must first complete the following steps before continuing with your migration. If you do not perform the below steps first, you will end up duplicating items in the destination mailbox:
- Remove all previously migrated data from the destination mailbox (or delete and recreate the destination mailbox).
- Create a new project with the other endpoint type (Example: if you were using Graph, create a new project using EWS endpoints. If you were using EWS, create a new project using Graph endpoints).
- If using the User Migration Bundle (UMB) license add the Mailbox as a new item to the new project. Do not move the Mailbox from one project to another.
- If using the Mailbox Migration License (up to 50 GB per license) move your Mailbox from your old project to the new project using the steps under Moving Items or Users in the MigrationWiz Projects KB article. Once the mailboxes have been moved to the new project, check the boxes to the left of the mailboxes and perform a Reset Items by selecting the icon shown below in the project and click the Reset Items button (Do not check the box labeled "Reset errors only for the selected items").
MigrationWiz now offers the option to migrate recoverable items in Microsoft 365 and Exchange environments. This option is applicable to Microsoft 365 to Microsoft 365 migration scenarios and Exchange (2013+ or Hosted) to Microsoft 365 migration scenarios.
Licensing
If a User Migration Bundle license is already assigned to your Mailbox/Archive Mailbox project, you do not need to purchase additional licenses. The same license will be applied to your recoverable items. For questions on licensing, visit Which Migration License Do I Need?.
Migrating Litigation Hold Data for Inactive Users
Inactive mailboxes are not supported with MigrationWiz. To migrate these users, activate them and migrate as part of a regular migration. Use the steps in this Microsoft document to restore the mailboxes before migrating: Restore an inactive mailbox
Archived recoverable items may now also be migrated for Microsoft 365 to Microsoft 365 migrations only.
This will migrate the following recoverable items:
- Calendar
- Contacts
- Tasks
- Journals
- Notes
The following folder types are supported:
- Recoverable items: Deletions
- Recoverable items: Purges
- Recoverable items: Versions
- Recoverable items: DiscoveryHolds
Important: Subfolders for Recoverable and Archived Recoverable items are not supported.
Migration Steps
Recoverable Items
To migrate Recoverable Items, follow the steps below.
- Create a new Mailbox migration project.
- Set source and destination to "Recoverable Items."
- Add the following Support Option:
- MigrateAllRecoverableItems=1 This option is needed to enable recoverable items migration.
-
OverrideRecoverableItemsFolderMapping=1 This option will apply folder mappings from source to destination for Deletions, Purges, and Versions. Without this item, all source folders will be migrated to Recoverable items -> Deletions.
- Start migration by selecting only "Mail" items in the "Select what to migrate" section. This will migrate all items. However, the folder type for recoverable items is recognized as a Mail folder by MigrationWiz.
Archived Recoverable Items
- Set up a Personal Archive Project.
- Set the source and destination to "Archive Recoverable Items."
- Add the following Support Options:
- MigrateAllRecoverableItems=1. This option is needed to enable recoverable items migration.
-
OverrideRecoverableItemsFolderMapping=1. This option will apply folder mappings from source to destination for Deletions, Purges, and Versions. Without this item, all source folders will be migrated to Recoverable items -> Deletions.
- Start migration by selecting only "Mail" items in the "Select what to migrate" section. This will migrate all items. However, the folder type for recoverable items is recognized as a Mail folder by MigrationWiz.
Both source and destination endpoints must be in Microsoft 365 for this option to be visible.
This is specific to Archive Recoverable Items.
Considerations
Default Support Options for Microsoft 365 Endpoints
By default, some fields are view-only. In other words, you cannot edit or remove them from the support options page. To edit them, you need to edit the source or destination endpoint of your project.
Among these default options, you can find ModernAuthClientIdExport, ModernAuthTenantIdExport, ModernAuthClientSecretExport, ModernAuthClientIdImport, ModernAuthTenantIdImport, and ModernAuthClientSecretImport.
The support options above are required when configuring your endpoint.
Important
Keep in mind that the ModernAuthClientSecretExport and the ModernAuthClientSecretImport support options are text-masked.
Warning
You cannot update the default Advanced Options, in case you try to modify or add new ones the following message arises.