Share via

Perform Google Workspace migration to Microsoft 365 or Office 365 using Exchange Online PowerShell

  • Article

Create a migration endpoint in Microsoft 365 or Office 365

  1. Connect to Exchange Online PowerShell.

  2. 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.

  3. Run the following command:

    Test-MigrationServerAvailability -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\\somepath\\yourkeyfile.json")) -EmailAddress [email protected]

  4. Verify the test is successful.

  5. If successful, run the following command:

    New-MigrationEndpoint -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\\somepath\\yourkeyfile.json")) -EmailAddress [email protected] -Name gmailEndpoint

Create a migration batch in Microsoft 365 or Office 365

  1. Connect to Exchange Online PowerShell.

  2. 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
[email protected]
[email protected]

  3. 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.

  4. 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: