This article provides instructions on configuring a migration batch for migrating Shared Drives from Google Workspace to SharePoint site document libraries.
Before proceeding, ensure you have completed the steps in the Migration Guide.
1. Adding Entities to Your Batch
You can migrate to a new SharePoint site (which CloudM will provision) or map a Shared Drive to an existing Document Library.
Example Configuration:
-
Source Shared Drive ID:
0AJdUYx8YE1ihUk9PVA -
Destination Site:
https://destination.sharepoint.com/sites/DestinationSite
Batch Settings:
- Export Type: Shared Drive
-
Export Name: The Shared Drive ID (e.g.,
0AJdUYx8YE1ihUk9PVA) - Import Type: Team Site
-
Import Name:
sites/DestinationSite -
Family Name:
Destination Site Name
The display name of the destination SharePoint site. -
Given Name:
Destination Library- ✅ Enter the exact display name of the destination library.
- Note: If your destination site is provisioned in a language other than English, enter the localized display name (e.g., 'Documentos', 'Dokumente', 'Documenten').
- ❌ Do not enter a URL or file path.
-
Documents Path: (Optional)
- Leave blank to migrate from the root of the Shared Drive.
- Enter a Folder ID to migrate only a specific sub-folder.
Further instructions on adding entities to your batch can be found here: Adding Items to a migration batch. Ensure the 'Migrate' checkbox is enabled for all entities you intend to include.
⚠️ Important Limitation
The configuration targets the specific Shared Drive (or root folder ID) and maps it to a Document Library. It is not possible to split a single Shared Drive across multiple libraries in one step without using specific sub-folder IDs.
2. Configuration Settings
General Settings
Ensure all domain mappings are configured correctly. You can also apply date range filters here.
Source Settings
Most source settings can remain at their default values. Source Settings Reference.
If you are specifying a folder within the source Shared Drive, the following setting is optional:
- Documents > Export documents path folder: Setting 'Export documents path folder' to true will export the folder specified in 'Documents path' on the users page (and not just the contents).
Destination Settings
- SharePoint Online > Migrate previous document versions: Enable to migrate historical versions. Note: This increases migration time.
- SharePoint Online > Maximum number of previous document versions: Select the limit.
- SharePoint Online > Provision Sites: Enable this to automatically provision SharePoint Sites at the destination if they do not exist.
Destination Settings Reference.
Advanced Settings
- Address Replacement: Highly recommended. Upload a CSV mapping source users/groups to destination equivalents. Address Replacements Reference.
3. The Migration Process
For a complete guide covering project planning, user communication, and checklists, please review our recommended strategy: