Supported editions for this feature: Business Starter, Business Standard, and Business Plus; Enterprise Standard and Enterprise Plus; Education Fundamentals, Education Standard, and Education Plus; Essentials Starter, Essentials, Enterprise Essentials, and Enterprise Essentials Plus; Nonprofits; G Suite Basic and G Suite Business. Compare your edition
Use advanced migration to scan batches of Exchange Online data before or after migrating it to Google Workspace. Migration scanning generates reports that help you plan new migrations and audit completed ones.
To learn more about advanced migration, go to Use advanced migration for Exchange Online.
Requirements
- A super administrator must manage the migration scan on the Workspace side. A global administrator, privileged role administrator, or other qualified user must approve the migration scan in Exchange Online.
- You need to verify your Workspace domain. If you have an Essentials edition, you need to verify before starting a migration scan. For details, go to Verify your domain for Google Workspace.
- You need an email address for every Exchange Online user that you want to scan. For details, go to Plan for where and how you will manage your user accounts.
- You can add up to 2,000 Exchange Online users to one migration scan. Additional users require a separate scan.
- You can create up to 50 migration scans (or a combination of migration scans and migration batches) at one time.
- You can run up to 10 migration scans (or a combination of migration scans and migration batches) simultaneously.
Run a migration scan
You must be signed in as a super administrator for this task. Resellers cannot migrate data for their customer accounts.
Before you begin: To ensure secure migration scanning from Exchange Online, you must first create a Microsoft Entra application within the Microsoft Azure portal. For details, go to Set up Microsoft Azure for advanced migration.
Step 1: Connect to your Microsoft Exchange Online account
-
In the Google Admin console, go to Menu
Data
Data import & export
Data import.
You must be signed in as a super administrator for this task.
- For Advanced, click New scan.
- For Scan name, enter a name for the migration scan and then click Continue.
- For Client ID, enter the unique ID number for your Exchange Online account.
- For Client Secret, enter the client secret value for your Microsoft Entra tenant.
- For Tenant ID, enter the unique ID number for your Microsoft Entra tenant.
- Click Connect.
Step 2: Select users to scan
Create a comma-separated values (CSV) file that lists the Exchange Online users that you want to scan. You can create a new CSV file. Or, download a sample file and add information. The completed CSV file must be smaller than 10 MB and contain no more than 2,000 users.
To get details about users in your Exchange Online tenant, go to Create a group in your organization.
To create the CSV file:
- Using your Workspace administrator account, open a spreadsheet program. Or, in the Admin console, select Download a sample CSV file.
- Add the header Source Exchange Email and add an email address for each Exchange Online user that you want to scan. Use a separate row for each email address.
Example:
Source Exchange Email kim@example.com alex@example.com - Save the spreadsheet as a CSV file.
- Upload the file to the Admin console:
- In your Admin console, click Upload CSV.
- Select the file
click Open.
- Click Tasks
to confirm that the file is successfully uploaded.
- If the CSV file doesn't successfully upload:
- Select the file and click Delete
Yes to confirm.
- Create a new file and try to upload it again.
If you encounter this issue more than once, go to Contact Google Workspace support.
- Select the file and click Delete
Step 3: Configure migration scan settings
Adjust the following settings to choose the data you want to scan.
- Click Edit settings.
- Check one or more of the following boxes to choose which data to scan for all your selected users:
- Calendar events
- Contacts
- For Date range, enter a date to start scanning data from the source you selected. All calendar events and email messages sent or received after this date are scanned and all contacts are scanned, regardless of creation date.
- (Optional) For Email options, check any of the following boxes to specify what kind of email information is scanned:
- Include deleted emails—Scan deleted email messages.
- Include junk emails—Scan email messages in spam folders.
- Exclude specific folders—Enter the excluded folder names, separated by commas. For details, go to Exclude folders from migration.
- (Optional) To scan the Exchange Online users' calendars and events, including calendars for personal appointments, check the Copy additional calendars box.
- Click Save changes.
Exclude folders from migration
- Separately add each Exchange Online folder or subfolder name.
- If you exclude a folder, the migration doesn't include its subfolders and any email messages in them.
- To exclude a subfolder, use the full path and separate the parent folder from the subfolder with a forward slash (/). For example:
- If you want to exclude the subfolder Asia in the folder Travel, enter Travel/Asia.
- If you also add Travel in the list, such as Travel, Travel/Asia, then all the subfolders are automatically excluded.
- To exclude a folder with a forward slash (/) in its name, replace each slash with an underscore (_). For example, to exclude Folder/with/slash, add it as Folder_with_slash.
- You can also exclude default Microsoft folders, such as Deleted Items, Inbox, or Junk email, and user-created folders.
Step 4: Start the migration scan and check its progress
- Click Start scan.
The status changes to In progress and the following information is updated in real time:
- Users processed—Number of users that were scanned for all selected data types.
- Emails discovered—Number of email messages in the Exchange Online users' accounts.
- Calendars discovered—Number of calendars that were migrated.
- Calendar events discovered—Number of events in the Exchange Online users' calendars.
- Contacts discovered—Number of contacts in the Exchange Online users' accounts.
- You can navigate away from the Scan status report page without interrupting the migration scan. Your migration scan continues unless you cancel it.
- (Optional) To export a report for a migration scan in progress:
- Click Export user report or View scan logs.
- If the Tasks list doesn't automatically open with the exported report, click Tasks
the report link.
- Click Open in Google Sheets to open the report in Sheets.
- To export and interpret the reports, go to Understand migration scan reports.
Step 5: Stop a migration scan in progress
To stop a migration scan that's in progress, click Stop scan. It might take a few minutes for the migration scan to stop, and the migration scan process does not roll back.
Step 6: Re-run a migration scan
After you successfully scan the data, you can click Re-run scan to scan any new and updated data.
If there are changes to previously scanned Exchange Online users or data, re-running the migration scan identifies and updates the migration scan report.
Exit a completed migration scan
You can re-run migration scans and review information about a completed migration scan in the Admin console until you exit the migration scan. You can't start a new migration scan until you exit a completed migration scan. To exit a completed migration scan:
- (Optional) If you want to save logs form a completed migration scan, click Export user report and View scan logs. For details, go to Understand migration scan reports.
- Click Exit scan
Exit and delete scan.
When you exit, the system deletes the client ID and removes Data Migration (New) as a client in the domain-wide delegation setting.
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.