Perform Google Workspace migration to Microsoft 365 or Office 365 using Exchange Online PowerShell
Create a migration endpoint in Microsoft 365 or Office 365
Find the email address for the super admin within the Google Workspace environment. This email address is used to test connectivity between Google Workspace and Microsoft 365 or Office 365. The following steps use 'admin123' as an example.
Run the following command:
Test-MigrationServerAvailability -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\\somepath\\yourkeyfile.json")) -EmailAddress admin123@fabrikaminc.net
Verify the test is successful.
If successful, run the following command:
New-MigrationEndpoint -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\\somepath\\yourkeyfile.json")) -EmailAddress admin123@fabrikaminc.net -Name gmailEndpoint
Create a migration batch in Microsoft 365 or Office 365
Create a CSV file containing the set of all of the users you want to migrate. You need the filename in the upcoming command. The allowed headers are:
- EmailAddress (required). Contains the primary email address for an existing Microsoft 365 or Office 365 mailbox.
- Username (optional). Contains the Gmail primary email address, if it differs from EmailAddress.
EmailAddress will@fabrikaminc.net user123@fabrikaminc.net
Run the following command:
New-MigrationBatch -SourceEndpoint gmailEndpoint -Name gmailBatch -CSVData $([System.IO.File]::ReadAllBytes("C:\\somepath\\gmail.csv")) -TargetDeliveryDomain "o365.fabrikaminc.net"
Tip
See New-MigrationBatch for an explanation of all of the individual parameters you can use with this cmdlet.
Run the following command to start the migration batch:
Start-MigrationBatch -Identity gmailBatch
Note
When the batch starts, all the users to be migrated will be converted from MailUsers to Mailboxes. The Microsoft 365 or Office 365 Exchange license must be assigned only after this moment. You have 30 days to assign the license.
For more information, see the following articles: