Chat now with support
Chat with Support

Welcome, erwin customers to Quest Support Portal click here for for frequently asked questions regarding servicing your supported assets.

Reference Materials for Migration 8.14 - Public Folder Synchronization (MAgE)

About This Document How It Works Before You Begin Public Folder Synchronization Workarounds Technical Reference

Managing Migration Agent for Exchange

The following cmdlets help you to manage Migration Agent for Exchange (MAgE):

Starting Synchronization

After the user accounts were successfully provisioned and calendars were successfully synchronized with Microsoft Exchange Online, you can synchronize public folders if necessary.

It is recommended to synchronize public folders before you start to migrate mailboxes. Before the users are migrated to the new environment, you need to copy the contents of the public folders to the new servers. This will ensure that the first migrated user will have access to up-to-date public folder information.

Two modes are now available:

  • Simple mode with minimal customization
  • Advanced mode

The following synchronization directions can now be selected to start synchronization process:

  • One-way synchronization from source to target. All changes on the target will not be synchronized.
  • Two-way synchronization between source and target. All changes will be synchronized.

This parameter can be set before migration project initialization using Export-MMExPublicFolderMappingor Initialize-MMExPublicFolderMigration cmdlets. Synchronization direction cannot be changed after initialization

To start public folder synchronization in simple mode, take the following steps:

  1. Register the Source and Target organizations in Migration Manager Console
  2. Verify that the host meets the requirements described in System Requirements.
  3. Run MMExPowerShell module as described in Configuring Migration Using PowerShell.
  4. Call Start-MMExPublicFolderMigration cmdlet for your source and target organizations. By default, all public folders from source organization will be added to synchronization job and synchronized to target . Refer to Start-MMExPublicFolderMigration for information on how you can limit the synchronization scope and for parameters you can set.

The following actions will be performed during the Start-MMExPublicFolderMigration execution with default settings:

  • Migration Agent for Exchange (MAgE) will be installed on the host by Install-MMExAgent cmdlet in case it is not already installed.
  • Object matching will be set for mail-enabled universal security distribution groups (Microsoft Office 365 only) by Set-MMExGroupMatching cmdlet.. Object matching is required to synchronize client permissions of these distribution groups. You can schedule this task using Task Scheduler. For details refer to Using Task Scheduler to Automate Tasks.
  • A mapping file for synchronization will be generated by Export-MMExPublicFolderMapping cmdlet. All public folders from the source organization will be included in this mapping file.
  • The mapping file will be used to create the empty public folders in the target organization by Import-MMExPublicFolderMapping cmdlet. Public folder structure and naming will fully match the source public folder hierarchy.
  • Project database for synchronization of public folders will be prepared using Initialize-MMExPublicFolderMigration cmdlet.
  • Migration Agent for Exchange (MAgE) will be started by Start-MMExAgent cmdlet.
  • Target public folders will be mail-enabled in case matched source public folders are mail-enabled using Sync-MMExMailPublicFolder. You can schedule this task using Task Scheduler. For details refer to Using Task Scheduler to Automate Tasks.

TIP: To synchronize proxy addresses, Send As permissions, Send On Behalf permissions, alias, simple display name properties for these public folders call Sync-MMExMailPublicFolder again with necessary settings after the Start-MMExPublicFolderMigration execution.

To start public folder synchronization in advanced mode, take the following steps:

  1. Register the Source and Target organizations in Migration Manager Console
  2. Verify that the host meets the requirements described in System Requirements.
  3. Run MMExPowerShell module as described in Configuring Migration Using PowerShell.
  4. Install Migration Agent for Exchange (MAgE) using Install-MMExAgent cmdlet.
  5. Call Set-MMExGroupMatching cmdlet for your source and target organizations to set object matching for migrated by Quest Migration Manager for Active Directory (Microsoft Office 365 only) mail-enabled universal security distribution groups.
  6. Call Export-MMExPublicFolderMappingcmdlet for your source organization to generate a mapping file for synchronization.
  7. Call Import-MMExPublicFolderMapping cmdlet for your target organization to create the empty public folders in the target organization according to the mapping file from the previous step.
  8. Stop MAgE using Stop-MMExAgent cmdlet in case it is started.
  9. Prepare project database for synchronization of public folders by calling Initialize-MMExPublicFolderMigration cmdlet.
  10. Mail-enable target public folders in case matched source public folders are mail-enabled and synchronize proxy addresses, Send As permissions, Send On Behalf permissions, alias, simple display name properties for these public folders using Sync-MMExMailPublicFolder.
  11. Start MAgE using Start-MMExAgent cmdlet to start synchronization.
  12. Call Get-MMExPublicFolderStatistics cmdlet to get synchronization statistics and monitor the process.

Mapping File Structure

The mapping is CSV file with the following fields:

  • SourceFolder field contains full path to source public folder, e.g.: in the following format: \CustomRoot\folder1
  • SourcePFMailbox field contains source public folder mailbox associated with source public folder. It is empty in case Exchange 2010 on source.
  • FolderSize specifies size of the source public folder.
  • FolderClass specifies class of the source public folder. The following valued are available: <values>.
  • TargetFolder field contains full path to paired target public folder in the following format: \CustomRoot\folder1.
  • TargetPFMailbox contains target public folder mailbox associated with target public folder.

Managing Public Folder Synchronization

To manage public folder synchronization, use the following cmdlets:

To manage mail-enabled settings and directory properties

  • The Restart-MMExPublicFolderMigration cmdlet searches the source for mail-enabled public folders, sets matched target public folders as mail-enabled, and synchronizes Active Directory properties of these public folder.

You can schedule this task using Task Scheduler. For details refer to Using Task Scheduler to Automate Tasks.

To manage synchronization process for specified folders

To monitor synchronization process

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating