Chat now with support
Chat with Support

On Demand Migration Current - Administrator Guide

About On Demand Migration Before You Start Working with On Demand Migration Starting Migration Project Configuring Connections Sharing Availability Information Collecting Account Information Pre-Migration Assessment Account Migration Hybrid Account Migration Domain Coexistence Mail Migration OneDrive Migration Resource Processing Public Folders Migration SharePoint Migration Microsoft Teams Migration Content Migration for Office 365 Groups Troubleshooting Finalizing the Migration

What We Migrate

Quest On Demand migrates the following OneDrive content:

Supported Entity Supported Entity Properties
  • Authorship properties
    • Created Date
    • Created by
    • Last Modified Date
    • Last Modified By
  • Document properties
  • Document permissions
  • Versions & Version History
  • Properties
  • Folder permissions
Direct Sharing Permissions
  • Permissions for:
    • Internal Users
    • Groups
    • Guest(External) Users
  • Custom level permissions

Link Sharing Permissions

Permissions for:

  • Internal Users
  • Groups
  • Guest (External) users

OneDrive Migration Considerations

Before starting the OneDrive migration, consider the following:

  • Migrating non-expired permissions from Sharing Links is not supported. Currently migrated permissions are always active whether or not the link has expired.
  • Migrating Authors/Editors will only map to the Primary SMTP Address. Multiple SMTP addresses are not currently supported.
  • Migrating a OneDrive user Recycle Bin is not supported.
  • Migrating Sharing Link permissions for external users requires the external user be an Azure Active Directory guest.
  • Unable to migrate a document to a target organization where the document URL will be longer than 400 characters

Refer to Sharing Permission Considerations for details.


  • It is highly recommended to match / migrate all accounts in the migration project to ensure that membership, content ownership, and permissions are processed correctly.
  • The target tenant should already have the fully configured OneDrive with the valid license plan. Note, that licenses can be automatically assigned to the target users during the migration.
  • Admin consents should already be granted for source and target tenants .The following admin consents should be granted for OneDrive migration feature:
    • Migration - Basic,
    • Migration - SharePoint

• Azure AD Administrative accounts credentials must also be provided for both tenants in the Configure Connections dialog.

In case necessary admin consents are not granted or expired, account discovery will be disabled and you will be unable to continue. To grant admin consents, open the Tenants page and grant necessary permissions to allow the product to access the source tenant and the target tenant. You will be redirected to the Microsoft web site for granting admin consent. Once admin consent is granted, you can start discovery.

Migrating OneDrive

Make sure that all associated accounts are matched or migrated and create the OneDrive Migration Task.

  1. Go to the migration project Dashboard in case you use new migration UI. In case you are using classic experience or you are already on the account migration Dashboard, go to step 3.
  2. Click Accounts widget.
  1. Open OneDrive and select accounts for which you want to migrate the storages.
  2. Click Migrate OneDrive.
  3. Select migration scope. The following migration options are available:
  • The latest version only (default)
  • The latest version and the previous version.
  • All versions

IMPORTANT: You can configure size limitation for previous file versions by selecting one of the possible values. By default, previous file versions are only migrated if their size is 80MB or less. If the size of the specific version exceeds the selected value, the previous version will be skipped.

  1. Select file migration action to speed up the migration process. The following options are available:
  • The source files that match the target files will be overwritten. This is only applicable to the migration scope selected above.
  • Skip if the target file is the same version or newer

The source file that match the target file will be overwritten only in case the source file is newer than target one. This is only applicable to the migration scope selected above.

  1. Select the migration action for file sharing permissions. The following options are available:
  • Do not migrate permissions.

Sharing permissions for migrated content will not be transferred. Sharing permissions for the content that is not migrated under this task remain unchanged.

  • Update permissions only for migrated content.

Sharing permissions for migrated content will be updated as specified in Sharing Permission Considerations. Sharing permissions for the content that is not migrated under this task remain unchanged.

  • Update permissions for all content.

Sharing permissions for all content will be updated as specified in Sharing Permission Considerations.


  1. Specify whether matched account will be displayed in Created by and Modified by properties of the migrated content. Consider that only properties related to matched / migrated users that have a mailbox with valid Microsoft Exchange Online license can be transferred. If there is no such users in target and the default target account is not set to be used instead, System Account will be displayed.
  2. Pick the active OneDrive for Business licensing plan that will be used on target tenant. Re-run the discovery task to update available licensing plan data, if necessary.
  3. Specify how the licenses will be assigned to the target users during the OneDrive for Business migration. Selected licensing option is only applicable to OneDrive migration. It does not affect the licensing plans picked for Exchange Online.

In case no usage location is set on the target the source value will be used for the assigned license. Otherwise the target usage location value remain unchanged and can be modified manually, if necessary.

Click Next to proceed.

  1. Specify which folders or files should be skipped during OneDrive migration processing. The following options are available:
  • Exclude specific folders... : specify semicolon-separated list of fully qualified paths to folders you want to skip. You can use slash or backslash. If it is convenient for you, use spaces after semicolons, e.g., filteredfolder; somefolder/subfolder
  • Exclude specific file types...: specify semicolon-separated list of file extensions (case-incentive) to skip specified file types. If it is convenient for you, use spaces and dots, e.g., .exe; dll; BAT
  • Exclude files created before: select the date to skip obsolete files, e.g., May 01, 2018
  • Exclude files modified after: select the date to skip unnecessary files, e.g., July 01, 2018
  • Exclude files bigger than (MB): skip very large files. The maximum value is 1000 MB; only integer values are supported.
  1. Schedule when the task will be started. See Task Scheduling for details.
  2. by default, migration task will be automatically rerun once if some files are missed on the source in comparison with the source. When you have many users in a task, there is a chance that some of the users can not have all of the content migrated because of some intermittent network issues or throttling. If this option remains selected, On Demand Migration will automatically run a second round of incremental migration for those users while other user migration are still going. This is the recommended way to migrate all the content for all the users in one task run. Consider that auto rerun only will be performed if there are not any files or folders excluded on the Items to Exclude page.
  3. Click Next. Name the task and check selected options. Click Finish to save or start the task depending on schedule option selected.

You can track its progress in the Tasks, view the summary on the Dashboard or monitor alerts, details, and notifications in the Events.

TIP: From Events list you can quickly navigate to the originating OneDrive Migration task or affected object, who owns the OneDrive storage processed. Refer to Tracking OneDrive Migration for details.

Related Documents