Aftab Alam | Published On - 04 Jan 2021 |

Read time 4 min

A business organization can use the Exchange Server as its email server with multiple deployment options – Exchange Server on-premises, Exchange Online, and Hybrid Exchange. Normal users will not feel any difference in their services as they can easily communicate with their clients and colleagues.

The Exchange administrator who manages all the user mailboxes can migrate the mailbox data between different deployments using the Exchange Admin Center and Exchange management shell. There are some prerequisites and permissions that the administrator should meet before starting the migration, but some chances are that the migration will show some error or warning and stop. Today, we will tackle one migration error and its best possible resolutions-

If you have a hybrid deployment and migrating a mailbox created in Exchange Online to on-premises Exchange, you may get an error related to the GUID value.

You can get the error details in the migration batch description with the migration status as failed.

What is a GUID Value?

The GUID value is the Globally Unique Identifier (GUID) associated with each mailbox that links the mailbox to Active Directory. This property is a member of the Exchange Mailbox class and gives a read-only value to the mailbox. You can consider it as the unique value that defines the association between Active Directory and mailboxes. It legitimizes the existence of the user account.

Cause of the Error

The main cause behind the error is that the GUID value is not associated with the on-premises Exchange. When the mailbox is migrated, then the value is not synced with the Exchange Online mailbox.
When you see the respective mailbox properties in the Active Directory, you can see that the GUID called msExchMailboxGuid is not set.

How to Resolve the Error?

The administrator needs to set Exchange GUID property on the mailbox before migrating the mailbox to resolve the error. Here is the process that you should follow to complete the process-

1. On the on-premises Exchange Server, open the Exchange Management Shell and run the following cmdlet to check if the Exchange GUID property is set on the mailbox.
   Get-RemoteMailbox ‘<MailboxName’> | Format-List ExchangeGUID

   If the cmdlet output shows the value of ExchangeGUID as zero, then it indicates that the GUID property is not set.

2. Now, open the Windows PowerShell, not the Exchange Management Shell, and connect it with the Exchange Online.
3. After connecting with Exchange Online, you need to run the above cmdlet again.
   Get-RemoteMailbox ‘<MailboxName’> | Format-List ExchangeGUID
4. When the cmdlet shows the value of GUID as zero, then run the following cmdlet to set the value.
   Set-RemoteMailbox ‘<MailboxName’> | -ExchangeGUID ‘<GUID’>
5. Perform the directory Synchronization.

Now, you can go ahead with the migration. But there are some precautions that you should take while starting the migration, which can save you from facing any error.

• The mailbox should be assigned permissions like the Mailbox Server Permissions, Recipient Management Permissions, Organization Management Permissions, etc.
• There should be a hybrid deployment between the Exchange Server on-premises and Exchange Online.
• At the on-premises Exchange Server 2013, the administrator should enable the Mailbox Replication Proxy Service (MRSProxy).
• The mailbox at the Microsoft 365 should be assigned the license only after the completion of the migration.

Conclusion

Smooth migration of Exchange mailboxes can be completed only when permissions and other values are set properly. But, if an ongoing batch migration fails, then the mailbox will not migrate. Only a seasoned Exchange Administrator can handle all such situations and migrate the mailboxes safely. If you use Kernel Migrator for Exchange to migrate mailboxes from any Exchange version or another or from Exchange Online (Office 365) to Exchange on-premises, it would be of help. Also, you can migrate between on-premises, Online, or hybrid deployments. This Exchange Migration tool lets you apply various filters and schedule large-scale migrations at a convenient time. The tool will provide a full migration report in the last.