Managing Migration Agent for Exchange
The following cmdlets help you to manage Migration Agent for Exchange (MAgE):
- Install-MMExAgent
- Get-MMExAgent
- Start-MMExAgent
- Stop-MMExAgent
- Repair-MMExAgent
- Restart-MMExAgent
- Uninstall-MMExAgent
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 Start-MMExPublicFolderMigrationor Initialize-MMExPublicFolderMigration cmdlets. Synchronization direction cannot be changed after initialization
To start public folder synchronization in simple mode, take the following steps:
- Register the Source and Target organizations in Migration Manager Console
- Verify that the host meets the requirements described in System Requirements.
- Run MMExPowerShell module as described in Configuring Migration Using PowerShell.
- 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:
- Register the Source and Target organizations in Migration Manager Console
- Verify that the host meets the requirements described in System Requirements.
- Run MMExPowerShell module as described in Configuring Migration Using PowerShell.
- Install Migration Agent for Exchange (MAgE) using Install-MMExAgent cmdlet.
- 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.
- Call Export-MMExPublicFolderMappingcmdlet for your source organization to generate a mapping file for synchronization.
- 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.
- Stop MAgE using Stop-MMExAgent cmdlet in case it is started.
- Prepare project database for synchronization of public folders by calling Initialize-MMExPublicFolderMigration cmdlet.
- 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.
- Start MAgE using Start-MMExAgent cmdlet to start synchronization.
- 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
- The Restart-MMExPublicFolderMigration cmdlet restarts migration for specified public folders. You can resynchronize content and permissions or permissions only.
- The Suspend-MMExPublicFolderMigration cmdlet suspends migration for specified public folders.
- The Resume-MMExPublic FolderMigration cmdlet resumes suspended migration for specified public folders.
- The Remove-MMExPublicFolderMigration cmdlet is intended for troubleshooting purposes only. Temporarily removes the public folder from the migration project and cleans all associated data in the migration project database to process this source public folder anew..
To monitor synchronization process
- The Get-MMExPublicFolderStatistics cmdlet gets synchronization statistics that can be used for all actions specified above as described in Tuning Statistics