Troubleshoot an Exchange connection

Here’s how to troubleshoot problems you might encounter when running a Microsoft Exchange connection.

Open all   |   Close all

Set up and connection errors

Exchange connection errors

To troubleshoot your Microsoft Exchange connection, make sure you: 

  • Meet all the system requirements for Exchange. Learn more
  • Have the correct Exchange administrator credentials. If the credentials changed, enter the new credentials and try again.
  • Use a third-party tool like EWSEditor to check if you can connect to your Exchange server from all servers running G Suite Migrate.

    Note: G Suite Migrate uses the same Exchange Web Services (EWS) connection method as EWSEditor. If the tool fails to connect, G Suite Migrate will not successfully connect. Work with your Exchange admin to resolve these connection issues.

    Third-party tools are not supported by Google. Problems with a third-party tool must be handled by the third-party vendor.
User validation

To complete basic user validation, make sure the user account:

  • Exists in Exchange and in G Suite.
  • Is not frozen, suspended, or renamed.

Troubleshoot email issues

Duplicate email messages

If you use email forwarding and the Accelerate Old Messages setting is turned on, set the Insert Before Date field to one day before email forwarding was turned on. G Suite Migrate uses this date to check that incoming email messages don’t already exist in the target mailbox.

For details on how to copy Exchange content using the Accelerate Old Messages setting, see Understand Exchange settings templates.

Exchange email filters

If your Exchange server uses complex filters, you might not see certain filters and actions migrated into G Suite. Not all Exchange actions and conditions map to a Gmail equivalent.

For a list of the Exchange filters that are not migrated, see Watchpoints and best practices for Exchange.

Missing email messages

Following a migration, you might notice that the number of email messages in the source environment exceeds the number of messages migrated to Gmail. 

This discrepancy might be due to the difference between folders in Exchange and labels in Gmail. In Exchange, when you assign a message to more than one folder, the message is duplicated. Following a migration, the duplications are removed in Gmail and different labels are applied instead. 

To verify that all messages have been migrated, check the logs for any errors. For details, go to Monitor progress with logs.

If you think you’re missing some messages, make sure: 

  • The message, including attachments, is not bigger than 25 MB. You can’t migrate messages bigger than 25 MB. For details, see Send attachments with your Gmail message.
  • An attachment to the message is not blocked by Gmail. Gmail blocks certain types of attachments, such as executable files. For details, see File types blocked in Gmail.
  • The message is in a folder or within a date range that’s part of the migration.
Set up delegated mailbox settings in Gmail

Both Exchange and Gmail allow users to delegate access to their email. However, G Suite Migrate doesn’t migrate delegation settings from Exchange. If you want to delegate access, you need to turn on mail delegation in Gmail after a migration. 

Important notes about Gmail delegation

  • Gmail doesn’t support folder level or read-only delegate access.
  • Each Gmail account has a maximum of 25 delegates.
  • The delegate must be an individual user, not a group in Google Groups.
  • Calendar permissions are managed separately from Gmail permissions.

Step 1: (Optional) Export delegate information from Exchange

In Exchange, a user can provide access to their mailbox using:

  • Mailbox delegation—A delegate has full mailbox access and can act on a user's behalf, for example, sending mail on behalf of another user. 
  • Folder sharing—A delegate can access mail folders but not act on a user's behalf. 

To export the delegate permissions from Exchange, in PowerShell choose an option: 

  • To extract mailbox delegation permissions (full access), use Get-MailboxPermission
  • To extract folder sharing permissions (access to mail folders), use Get-MailboxFolderPermission

Step 2: Turn on mail delegation in the Admin console

Before your users can delegate access to their mailboxes, you need to turn on a setting in the Google Admin console. See Turn mail delegation on or off.

Tip: You can limit who can set up mail delegation by adding those users to an organizational unit. 

Step 3: Set up mail delegation for users

Choose an option:

Tip: You can use an open source tool to script Gmail API settings changes. See GAM.

Other options

In Gmail, you can send messages from an address belonging to another user or group in Google Groups without granting mailbox access. For details, see Send emails from a different address or alias. You can also use the Gmail API to control this setting. 

Related topics

See these Microsoft articles for information on delegate access:

Troubleshoot calendar issues

Missing organizer on Exchange calendars

If you see a 400 error relating to Exchange calendars, make sure the original event organizer was not removed from Exchange. If they were, use the settings template for Exchange to assign a default email address and to set a suffix in the calendar event to reset the organizer.

For details, see Use a settings template.

Related topics

Troubleshoot G Suite Migrate


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.