This article provides instructions on configuring a migration batch for migrating SharePoint Sites to Google Workspace Shared Drives. The setup process outlined here focuses on migrating documents.
Before proceeding, ensure you have completed the steps in the Migration Guide.
Important: When setting up your source connections, you must add the SharePoint Admin URL. See How to find the SharePoint Admin Url.
1. Adding Entities to Your Batch
Migrating All Document Libraries (Common)
CloudM Migrate will create a folder in the destination Shared Drive for each document library found in the SharePoint site.
Example Configuration:
-
Source:
https://source.sharepoint.com/sites/SourceSite -
Destination:
Destination Shared Drive
Batch Settings:
- Export Type: Team Site
-
Export Name:
https://source.sharepoint.com/sites/SourceSite - Import Type: Shared Drive
-
Import Name: The Shared Drive Name (e.g.,
Destination Shared Drive) OR ID (e.g.,0AJdUYx8YE1ihUk9PVA).- Create New: Enter a name. CloudM will create the drive.
- Use Existing: Enter the Shared Drive ID.
- Documents Destination Path: The name of a folder which will be created in the destination for the data to be migrated into (optional; leave blank if migrating to the root of the destination Shared Drive).
Migrating a Single Document Library
Use this configuration to migrate a specific document library. A folder matching the library name will be created in the Shared Drive.
Batch Settings:
- Export Type: Team Site
-
Export Name:
https://source.sharepoint.com/sites/SourceSite - Import Type: Shared Drive
-
Import Name:
Destination Shared Drive(Name) or ID. -
Document Path:
Source Library- ✅ Enter the exact display name of the source library.
- Note: If your source site is provisioned in a language other than English, ensure you enter the localized display name (e.g., 'Documentos', 'Dokumente', 'Documenten').
- ❌ Do not enter a URL or file path.
- Documents Destination Path: The name of a folder which will be created in the destination for the data to be migrated into (optional; leave blank if migrating to the root of the destination Shared Drive).
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
Migration Scope: CloudM Migrate operates at the Document Library level. It is not possible to specify or isolate a single folder within a library for migration.
2. Configuration Settings
General Settings
Ensure all domain mappings are configured correctly to facilitate replacing the source domain with the destination domain.
Source Settings
- SharePoint Online > Default document library name: Modify this to match the language used in your source tenant (e.g., 'Documentos' for Spanish, 'Dokumente' for German).
- SharePoint Online > Document sharing/permissions: Enable to migrate permissions.
Destination Settings
- Shared Drive > Shared drive file permissions: Set to "File" to replicate SharePoint file permissions.
- Shared Drive > Shared drive folder permissions: Set to "Folder" to replicate SharePoint folder permissions.
- Shared Drive > Shared drive default managers: Provide valid user email addresses to assign as temporary managers. Note: Group email addresses are not permitted.
- User > Create users/resources/groups/shared drives: Enable this to ensure Migrate creates any Shared Drives that do not already exist.
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: