Chat now with support
Chat with Support

Metalogix Essentials for Office 365 2.4 - User Guide

Metalogix Essentials for Office 365 User Guide
Administrator Architect Backup
Interface Overview Common Functions
Connecting to SharePoint and OneDrive for Business Connecting to Cloud Storage Global and SharePoint Administrators Hyper Backup Creating a Full Backup Creating an Update Backup Creating an Exchange Online Mailbox Backup Creating an Office 365 Group Backup Creating a OneDrive for Business Backup Backup Resume Backup Search Restore from Backup Scheduling Backup Jobs Retention Policies Import/Export Backup Archives Moving the Backup Location Backup Project Conversion
Interface Overview Common Functions
Connecting to Drives Copy Google Drive Copy File Share Copy My Sites to OneDrive for Business Copy Tenant Copy Box Copy Dropbox OneDrive Management Progress Tab Hyper Migration Path Length Overflow
File Manager Informant Migrator
Interface Common Functions
Connect to SharePoint and OneDrive for Business Global and SharePoint Administrators Copy Sites Live Compare Copy Lists and Libraries Copy, Move, and Tag SharePoint Content Copy Alerts Pre-Migration Report Azure Turbo Mode In-Place Tagging of SharePoint Items Incremental Copy Nintex Workflow Migration Orphaned Users Copy Preserving Content Authorship and Approve/Reject Statuses Save Site to XML Using Scripts and Integration With Windows Task Scheduler
Profile and Global Variables Public Folders for SharePoint Reporting and Re-Mapping Users and Templates Security Manager Term Store Manager Scripts Wizards Appendix

Copy Google Drive

This section provides an overview of the Copy Google Drive functionality.

Copy Google Drives to OneDrive for Business

​​​​This option allows administrators to move content of multiple Google Drives to OneDrive for Business in a single move.


NOTE: If you have not already performed the prerequisite steps in Google, please go to this section first.  Once the prerequisite configuration is complete, return here to continue with the migration.

To migrate content of multiple Google Drives, perform the following:

1.On the Drives tab click Copy Google Drive > Copy Google Drive to OneDrive.
Copy Google to OneDrive01
The Google Drive to OneDrive Migrator wizard opens.

2.Select a Profile and give your project a name.
copy google to one001

3.Provide your Google Admin login, P12 Key File and Service Account in the Google connection parameters area. This information is gathered directly from your Google environment, so if you have not already please refer to this section for the required steps.  Once the values are entered, click Connect.  If you receive any message other than "Successfully connected to Google Drive", double check the prerequisite steps and then entered values.  If you are still experiencing issues, please contact Support for assistance.
Copy Google to OneDrive1

4.Specify your tenant SharePoint Administration Center URL​ and then click Connect.  When prompted, enter your Office 365 Global Administrator login and password. Click Connect. If you receive any message other than Successfully connected to SharePoint Admin, double check the URL and make sure you are supplying a Global Administrator login for this tenant.  If you are still experiencing issues, please contact Support for further assistance.
Copy Google to OneDrive2

5.​Click Load from Google to load a list of available Google Drive accounts from your environment. Select the account you wish to migrate.


NOTE: For a large number of Google Drives, it's recommended to load them by pressing the Load from CSV button.

Copy Google to OneDrive3

6.You can also choose to Load and Apply report option, which allows you to load and apply an Analyze Google Drive report, which then sets the Migration Priority for each user mentioned in the report. Click Next to continue.


NOTE: Each Migration Priority value can be changed if you click on the value in the Migration Priority columns (without user selection). It changes the migration queue but does not change the original report file. Priority in the wizard is not saved after the wizard has been closed.

Analyze OneDrive 4

7.Check the Re-Map Users option and load your user mapping CSV file (Please see this section for instructions on how to create a CSV User Mapping file for Google Drive to OneDrive).  User mapping is required so the software can properly resolve the differences between your users' Google and Office 365 accounts.  
Copy Google to OneDrive5

8.Click Check for users personal sites in order to begin the validation process​. This process will validate that the supplied user mapping is correct (Office 365 user accounts were located) and check to determine if each user currently has a OneDrive for Business for the site provisioned.  If one or more valid users do not have a OneDrive for Business site currently provisioned, select them and check Create personal sites for the selected users option. Click Next.
Copy Google to OneDrive6

9.If necessary, change content and file format conversion options​ as described below:
Content Options:
Copy Google to OneDrive7

·Copy Content - A flag to determine if content is or is not included with this operation.  When not included the remainder of the options will become disabled.

·Include Versions - The process in which Google revision history will be converted into OneDrive for Business versions.  Please note that this option is only referring to the major revisions (those shown as the "less detailed revisions") and not those that are automatically generated within Google Drives (those shown as the "more detailed" revisions). You can select whether you would like to:

oInclude All Versions

oInclude The Most Recent Versions - this option allows you to specify how many recent versions you would like to copy the content from.

·Incremental Copy - When enabled, the migration process will identify and migrate only that content which was created, modified or versioned within the defined interval (days, weeks or months). To perform a Delta migration, enter zero in the field and select days as the time period. Delta migration is designed to be used in scenarios where both the source and destination may be modified during the course of the migration.


NOTE: delta migration compares dates between source and destination to determine which content to include, so it will take more time to process than an incremental migration.

·Skip Files Greater Than - When enabled, this option will skip any source files that are greater than the value specified (in MB or GB). An entry will be added to the post-migration log indicating which file(s) were skipped due to this configuration.

·Migrate to Folder - When this option is enabled, you can create, or use an existing, root folder structure in the destination library where your source content will be migrated.  You will need to define the path, for example:
/My Source Content/2017
In the above example, the folder "My Source Content" and sub-folder "2017" will be created in the root library of your destination and all source content will be migrated to this folder location.

·Copy Permissions - Will convert Google shared permissions into OneDrive for Business shared permissions.


NOTE: Select the "Copy Permissions" option in order to copy content permissions.

Google Drive Shared Permission

OneDrive for Business Sharing Permission

Is owner

Full Control

Can edit

Can edit (Contribute)

Can comment

Can view (Read)

Can view

Can view (Read)

·Skipped Non-Owned Files - This addresses the possible scenario where content exists in the user's Google Drive "My Drive" area which is not owned by this user.  Skipping these objects will prevent duplicate content from being migrated into OneDrive for Business.

·Include First Reference File Only - This option addresses the possible scenario where a user creates reference objects (links using Shift + Z in Google Drive) of a file in various locations throughout their Google Drive environment.  Skipping these additional references will prevent duplicate files from being migrated into OneDrive for Business by migrating only the first reference found.  Please note that the "first" reference is defined by a list of parent folders returned from Google Drive and the first may not always be the same one on subsequent or incremental migrations.  Please also note this option is only applicable to files, all referenced folders will be copied.

·Include Orphaned Files - For the purpose of this option, an orphaned file is defined as a file that was created in a folder that was shared with this user and after the file was created, their permission to the shared folder was removed.  The file still exists in the user's Google Drive, however it does not reside in any visible folder path and can only be located using the Google Drive Search Bar.  When enabled, the migration will identify these orphaned files and migrate them to the mapped OneDrive for Business Documents library.  In this library, a new folder named "Orphaned Files" will be created which will contain all the migrated orphaned files.  The use of this option can decrease overall migration performance.

Format Conversion:
This set of options to determine how Google formatted content will be converted into Microsoft compatiable content.
Copy Google to OneDrive8

Adanced Options:
advanced options in Drives wizard

Enable Azure Turbo Mode: When enabled, this option utilizes Microsoft's SharePoint Online Migration API to increase the migration performance and throughput. A recommendation for optimal use of this API is larger sets of data; the more content, the better the throughput. Please review the User Manual for additional information as well as recommended configuration as this process is a resource intensive operation.

Because this API uses Azure storage as a staging area for the migration, it requires that you provide an Azure storage location. The options are to either utilize Microsoft supplied storage or to provide your own Azure storage location. If you wish to use your own Azure account, you must provide both the Azure Account Name as well as the corresponding Acces Key. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding or consider using the Microsoft Supplied Storage option. For more information please see the Azure Turbo Mode section.


NOTE: this function is optional and is only used to increase the migration performance to SharePoint Online or OneDrive for Business in Office 365. It does not provide any additional functionality that is not available when this option is disabled.

·Microsoft Provided Storage: This option allows you to use Microsoft provided Azure storage instead of providing your own for the purpose of utilizing Azure Turbo Mode.


NOTE: the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

·User Provided Storage: This option allows you to provide your own Azure Storage instead of using one provided by Microsoft for the purpose of utilizing Azure Turbo Mode. It requires that you provide both your Azure Blob Storage Account Name as well as its corresponding Access Key by clicking the "Select" button to the right. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding.


NOTE: that the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

oDefer Upload to Azure: When enabled, this option does not upload and immediately queue the import process from Azure storage, but rather saves the packages to a file location to then be uploaded and imported at a later time. This will allow you to use another application (at any time) to upload the content to Azure.

§To make use of the Deferred Upload option, the following process takes place:

1.First, you should setup the operation as usual using the Azure Turbo option.

2.Then, check the Defer Upload to Azure option and then Select the location where you wish to store the packages. Please be sure that there is enough disk space to accommodate all the packages that will be created.

3.During this process, the packages will be created, saved to this location and empty containers will also be created in your Azure storage.

4.After the operation completes, you will need to upload (using whichever upload utility you choose) the contents of each local folder into the appropriate Azure container. The folder names created in your local file location will be named exactly the same as the containers in Azure.

5.Once all the content from each folder is uploaded to the appropriate container in Azure storage, open the Azure Turbo Queue and choose the Refresh option.

6.Select one or more of the "Pending" jobs, right click and choose Process. The Import process has now begun and the jobs should soon switch to the status Queued.

oSend Notification: When selected, this feature will send emails to the listed recipients once Migrations are completed.

Create User Specific Log File - If you would like a user specific log file (.txt format) created for each migrated Google Drive, that will be saved directly to that Group's "Documents" library, check this option before you finish.  This log file will contain all the content that was included in the migration with both source and target URLs as well as any file renaming that took place and skipped files due to lack of ownership.
NOTE: Create user Specific log file is disabled if Azure Turbo Asynchronous mode is on. Supported only for CSOM or Azure Turbo Synchronous modes.
copy box to onedrive14

10. Click Finish to begin the migration process.

Please visit the following link to view the list of unsupported Google Drive objects.

Please visit the following link for an overview on how to script and schedule jobs such as Copying Google Drive to OneDrive for Business.

Google Group Mapping

When migrating from Google Drive to OneDrive for Business it may be necessary to re-map your Google based groups into existing Office 365 groups.

This may be necessary when you have a group on your Google document that you want to translate into another group in your Office 365 environment.

1.In your Google Drive, open the 'share' pane of the file that you want to map the group from.
As is shown in the image above, "" is the group. When migrating this into OneDrive, it will become "EDI At".

2.Find the Group that you want to map this Google Drive group to in Sharepoint. On this screen, copy the Account for the group that you want to map into within OneDrive.

3.Make a new entry in your User Mapping file for the Group.

As you can see, use the information from the Google side on the leftmost column and use the information from your SharePoint side on the rightmost column. When you use this mapping file, your group should map from Google Drive to an existing group in OneDrive.


NOTE: When creating your mapping you can use full group names and domains (,groupname) or you can simply set it up using the group name without the domain (edi,groupname)

Google User Mapping

When migrating from Google Drive to OneDrive for Business it may be necessary to re-map your Google based user accounts into their new Office 365 user accounts.

A migration example that may not require user mapping:

Google User Account

Office 365 User Account

Both the username (user1) and domain ( are identical between Google and Office 365.  (If you are using a email to authenticate against Office 365, then you will need to map all users even if the usernames and domain are identical.)

A few migration examples that would require the use of a mapping file:

Google User Account

Office 365 User Account

The username (user1) is the same between Google and Office 365, however the domain has changed ( |

Both the username (user1 | and the domain ( | is different.

The domain is the same (, but the username has changed (user1 |

Based on the examples above, if your situation requires the use of a mapping file, please create it using the steps below.

1.Create a new blank worksheet in Excel.

2.In Column A, enter the list of Google User Accounts.

3.In Column B, enter the list of Office 365 User Accounts next to their respective Google Accounts.

4.When complete, save this to a CSV file.

If you are not using Excel, then please create this mapping in a text file and then change the file extension to CSV when complete.  The file format should look similar to this when viewed in a text editor:,,,,,

Click here to download an example user mapping file.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating