Chat now with support
Chat with Support

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

Set-MMExGroupMatching

Sets object matching for migrated by Quest Migration Manager for Active Directory (Microsoft Office 365) mail-enabled universal security distribution groups.

Detailed Description

The Set-MMExGroupMatching сmdlet searches the source organization My Source Organization for mail-enabled universal security distribution groups and then copies legacyExchangeDN of each source group as an X500 address for migrated target group to set object matching. It is required to synchronize client permissions of these distribution groups.

Caution: This command should be performed before starting the public folder migration process. It is recommended to repeat this command in case a new mail-enabled universal security distribution group is added.

Syntax

Set-MMExGroupMatching

-SourceOrganization <source organization name (as displayed in tree-view)>

-TargetOrganization <target organization name (as displayed in tree-view)>

Example
Set-MMExGroupMatching -SourceOrganization 'My Source Organization' -TargetOrganization 'My Target Organization'

This command searches the source organization My Source Organization for mail-enabled universal security distribution groups and then copies legacyExchangeDN of each source group as an X500 address to migrated mail-enabled universal security distribution group on the target organization My Target Organization to synchronize client properties of these distribution groups and to set object matching.

Parameters
 -SourceOrganization
        

Specifies the source organization from which mail-enabled universal security distribution groups will be migrated.

Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
 -TargetOrganization
        

Specifies the target organization to which mail-enabled universal security distribution groups will be migrated.

Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false

Import-MMExPublicFolderMapping

Imports public folder mapping to provision public folder mailboxes in target.

Detailed Description

The Import-MMExPublicFolderMapping cmdlet imports public folder mapping from a comma-separated values (CSV) file for provisioning necessary public folder mailboxes on target. This operation is required to prepare public folder synchronization and in case of changes in source public folder hierarchy as described in Workarounds

During import operation, Migration Manager for Exchange reads files and connects to source and to target organization using credentials from the project database to ensure that these public folders exist in source and in target and can be processed. In case this verification is successful, the public folder pair will be added to database for synchronization, but really synchronization will be started after initialization.

Syntax

Import-MMExPublicFolderMapping

-MappingFilePath <path and filename for the output CSV file>

-Organization <target organization name (as displayed in tree-view)>

[-TargetMailboxNameTemplate <Mailbox name prefix>]

[-TargetRootFolderName <root folder name>]

Examples
Import-MMExPublicFolderMapping -MappingFilePath MigrationMapping.csv -Organization 'My Target Organization'

This command imports public folder mapping from "MigrationMapping.csv" file and provisions public folder mailboxes and empty public folders in organization named 'My Target Organization' according CSV file values.

Parameters
-MappingFilePath

Specifies the full path for the output CSV file to be generated.

TIP: If only file name is specified for CSV file, then the output file will be generated in the current directory.

Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
            -Organization
        

Specifies the target organization to which mail-enabled universal security distribution groups will be migrated.

Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
            -TargetMailboxNameTemplate
        

Specifies naming template for target public folders mailboxes.

Required? false
Position? 3
Default value PfMigrationMailbox
Accept pipeline input? false
Accept wildcard characters? false
-TargetRootFolderName

Specifies name of a folder that will contain migrated public folders on target

Required? false
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
Inputs

Organization

MappingFilePath

TargetMailboxNameTemplate

TargetRootFolderName

Outputs

CSV file

Initialize-MMExPublicFolderMigration

Prepares public folder migration project database for synchronization

IMPORTANT: MAgE must be stopped before this operation, in case it is started.

Detailed Description

The Initialize-MMExPublicFolderMigration cmdlet prepares project database for public folder migration using specified CSV file. This operation is required to start public folder migration and in case of changes in source public folder hierarchy as described in Workarounds. The CSV file contains SourceFolder, FolderSize, FolderClass, TargetFolder and TargetPFMailbox fields.

Syntax

Initialize-MMExPublicFolderMigration

-MappingFilePath <path and filename for the output CSV file>

-SourceOrganization <source organization name (as displayed in tree-view)>

-TargetOrganization <target organization name (as displayed in tree-view)>

[-Direction]

Examples

Example 1

Initialize-MMExPublicFolderMigration -MappingFilePath MigrationMapping.csv -SourceOrganization 'My Source Organization' -TargetOrganization 'My Target Organization'

This command imports public folder mapping from "MigrationMapping.csv" file and prepares project database for public folders migration from organization 'My Source Organization' to organization 'My Target Organization'.

Example 2

Initialize-MMExPublicFolderMigration -MappingFilePath MigrationMapping.csv -SourceOrganization 'My Source Organization' -TargetOrganization 'My Target Organization' -Direction OneWay

This command imports public folder mapping from "MigrationMapping.csv" file and prepares project database for public folders migration from organization 'My Source Organization' to organization 'My Target Organization' with 1- way synchronization from source to target.

Parameters
-MappingFilePath

Specifies the full path for the output CSV file to be generated.

TIP: If only file name is specified for CSV file, then the output file will be generated in the current directory.

Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
 -SourceOrganization
        

Specifies the source organization from which mail-enabled universal security distribution groups will be migrated.

Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
 -TargetOrganization
        

Specifies the target organization to which mail-enabled universal security distribution groups will be migrated.

Required? true
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false

-Direction

Specifies public folder synchronization direction. The following values are available:

  • OneWay - 1-way public folder synchronization
  • TwoWay - 2-way public folder synchronization

IMPORTANT: This decision applies to the current migration project and cannot be changed later. In case this parameter is not set you will be prompted to make this selection during initialization.

Required? false
Position? 4
Default value none
Accept pipeline input? false
Accept wildcard characters? false
Inputs

SourceOrganization

TargetOrganization

MappingFilePath

 

Restart-MMExPublicFolderMigration

Restarts public folder synchronization..

Detailed Description

The Restart-MMExPublicFolderMigration cmdlet restarts migration for specified public folders. This operation is also known as Resynchronization. See Managing Public Folder Synchronization for details.

Two resynchronization modes are available depending on UseSmartResync value for the project:

UseSmartResync is set to False

Permissions and folder content will be resynchronized for specified public folder. Migration will be restarted for public folder and all currently available permissions and messages from source will be migrated to target again. It can be useful in case some messages or permissions were found to be migrated incorrectly, Restart of migration forces MAgE to repeat data transferring attempt.

NOTE: Mage will not CleanUp ALL content of target public folder. For 1-way synchronization, Mage will reapply all permissions from the source folder to target and will migrate all source messages to target. If some of those messages had been previously migrated by Mage, old copies will be overwritten (recreated).

UseSmartResync is set to True

Only items that were not previously migrated to the target will bewill be resynchronized for specified public folder. For example, some messages failed to migrate to target with the following error: The message exceeds the maximum supported size. Administrator can reset the limits for affected public folder and initiate re-migration of such failed items using Restart-MMExPublicFolderMigration and UseSmartResync set to True.

Syntax

Restart-MMExPublicFolderMigration

-FolderId <public folder ID value>

[<CommonParameters>]

Examples

Example 1

Restart-MMExPublicFolderMigration -FolderId 5 

This command restarts synchronization for single public folder specified by public folder identifier 5. Identifier could be retrieved using Get-MMExPublicFolderStatistics cmdlet or from a log file.

Synchronization was restarted for the public folder MyFolder with identifier 5

Parameters
            -FolderID
        

Specifies the identifier of a public folder to restart.

Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false

 

TIP: You can find public folder identifier in the log entry, it is a number after the "M":

e.g., in the following log entry

2019-01-28 11:50:52.7225 Px1F48 Tx27 A1 C2 M7 Trace ...

public folder identifier is "7".

Inputs

SourceOrganization

TargetOrganization

MappingFilePath

Related Documents