Once the users are matched/migrated, you can transfer the content of their OneDrive for Business storages to the target tenant.
Before starting the OneDrive migration, consider the following:
- Migration may take a considerable amount of time, depending on the volume of data in storages.
- We only migrate files and folders present at the source OneDrive when the migration is started. Any changes made on the source during and after the migration are ignored.
- Re-migration overwrites all files in the target OneDrive. If OneDrive for Business sync client is already switched to the target tenant, all files will be re-synced, except for files, which target path is longer than 260 characters. Such files should be removed before restarting the migration to be updated. The existing copies of files stored on the local machines will be moved to the Recycle Bin.
- Migration of files, which target path is more than 400 characters is not currently supported. These files will be skipped.
- Only sharing permissions that are specified directly for accounts and groups that have matches on target are transferred. Refer to Sharing Permission Considerations for details.
- If a user or group is migrated and they have files shared with the group members, they will not be able to see them after migration. This functionality is not supported by Microsoft. The sharing can be restored manually after the migration is finished.
- Previous file versions are only migrated if their size is 80MB or less.
- Custom file properties (metadata) are not transferred to the target.
- Preferred data location (PDL) information is ignored for Multi-Geo tenant migration.
IMPORTANT: SharePoint system account will be set in Modified by information for all migrated content.
Make sure that all associated accounts are matched or migrated and create the OneDrive Migration Task.
- Open OneDrive and select accounts for which you want to migrate the storages.
- Click Migrate OneDrive.
- Select migration scope. The following migration options are available:
- The latest version only (default)
- The latest version and the previous version.
- All versions
IMPORTANT: Previous file versions are only migrated if their size is 80MB or less. If the size of the specific version exceeds 80MB, that version is skipped.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Schedule when the task will be started. See Task Scheduling for details.
- Verify the current permissions that are necessary for completing the task and adjust them if necessary. Refer to Required Permissions for details.
- 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.
Sharing Permission Considerations
Sharing permissions can be transferred for Office 365 groups, security groups and user accounts that have matches on the target tenant. The sharing permissions of the groups and users that have no match on the target tenant will be ignored and related warnings are reported.
In case any sharing permission will be removed on the source after the file or folder is migrated, the links to this file or folder are still visible in Shared with me and Shared by me views on OneDrive for Business Online, but the file or folder cannot be accessed.
- Group permissions are not displayed in Shared with me view because Microsoft currently does not support this functionality.
- For shared folders, only the top level folder is displayed in the folder tree.
For migrated files and folders that do not exist in target before migration, source permission will always be used.
Consider the following specifics on how file sharing permissions will be handled for migrated files and folders that exist in target before migration:
For users as permission holder (internal/external) and groups as permission holder (Office 365 group or security group) sharing permissions will be handled as follows:
- For files if Overwrite target files for selected migration... option is selected, source file sharing permission will be used.
- For files if Skip if the target file is the same version or newer option is selected, target file sharing permission will be used.
- For folders if Skip if the target file is the same version or newer or Overwrite target files for selected migration... option is selected, target sharing permission will be used as a base, any addition of permissions inside the source will be added onto the target.
For existing files and folders, the inherited permissions will follow the same rules.
Tracking OneDrive Migration
Depending on selected migration options, file size, and number of permissions, the content of OneDrive storages is transferred in separate batches that can be submitted for processing to Microsoft OneDrive at the same time. These batches will be processed concurrently, it can take a while before Microsoft OneDrive complete processing of submitted batches. To help tracking current status for every user, the following statistics events are currently supported:
- Aggregated statistics for batches that are processed will be reported every 10 minutes for every OneDrive storage selected for migration task. This events contain batch processing statistics and information on batch packages that are queued or processed by Microsoft OneDrive more than 30 minutes, if any.
- Batch package status is reported separately for all batches that are not transferred by Microsoft OneDrive in more than 30 minutes after submission. The status is retrieved for batches that are queued or processed by Microsoft more than 30 minutes only. Depending on Microsoft processing speed the status can be "Queued" or "Processing".