Upcoming change in the way migration batches for public folders are created

This post has been republished via RSS; it originally appeared at: New blog articles in Microsoft Tech Community.

A new mandatory parameter, SourcePfPrimaryMailboxGuid, is being added to the New-MigrationBatch command for public folder migrations from Exchange 2013 (or later) on-premises to Exchange Online.

Why are we making this change?

Before this change, we relied on the on-premises server to find the primary public folder mailbox and route the Mailbox Replication Service (MRS) to the correct server. However, there were limitations with this method as the on-premises server relied on organization mailbox to proxy the call. In some cases, if the on-premises server routed the call to the wrong server, the migration batch could fail with MailboxDatabaseNotOnServerTransientException error.

With the introduction of this new parameter, we are eliminating the uncertainty involved in proxying of the MRS call. The change will ensure MRS will reach to the correct on-premises server hosting the primary public folder mailbox in all scenarios.

The change is specific to migration of public folder deployments on Exchange Server 2013 and above (public folder migrations from Exchange Server 2010 will continue to be same). Also, the change does not affect any on-going migration batches, only newly created migration batches will need to use this parameter.

Here’s an example of a new way of creating migration batch:

Step 1: Find out the GUID of primary hierarchy mailbox on-premises

On your on-premises Exchange server, open Exchange Management Shell and run the following command:

 

(Get-OrganizationConfig).RootPublicFolderMailbox.HierarchyMailboxGuid.GUID

 

Example:

 

[PS] C:\>(Get-OrganizationConfig).RootPublicFolderMailbox.HierarchyMailboxGuid.GUID 91edc6dd-478a-497c-8731-b0b793f5a986

 

Step 2: Create the migration batch

Open the EXO Management Shell and use the GUID from Step 1 to create the migration batch:

 

New-MigrationBatch -Name PublicFolderMigration -CSVData $bytes -SourceEndpoint $PfEndpoint.Identity -SourcePfPrimaryMailboxGuid 91edc6dd-478a-497c-8731-b0b793f5a986 -AutoStart

 

Please check the following documentation to find more details about the change:

The change is already being rolled out. If you receive following error when creating the migration batch, your tenant has already received the change:

 

"Source public folder PrimaryMailboxGuid is required for public folder migration."

 

Public Folder team

Leave a Reply

Your email address will not be published. Required fields are marked *

*

This site uses Akismet to reduce spam. Learn how your comment data is processed.