지금 지원 담당자와 채팅
지원 담당자와 채팅

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

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

Sync-MMExMailPublicFolder

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.

This task can be scheduled as described in Using Task Scheduler to Automate Tasks

Detailed Description

The Sync-MMExMailPublicFolder searches the source for mail-enabled public folders, sets matched target public folders as mail-enabled, and synchronizes proxy addresses, Send As permissions, Send On Behalf permissions, alias, custom attributes, simple display name properties from mail-enabled source public folder to matched target public folder. Also this cmdlet synchronizes public folder mailbox visibility in the GAL and copies legacyExchangeDN of each source public folder as an X500 address for migrated target public folder.

Caution: It is highly recommended to execute right after public folder migration initialization. It is recommended to repeat this command in case of changes in the source that can affect public folder synchronization (for example, a new mail-enabled public folder added).

Syntax

Sync-MMExMailPublicFolder

-SourcePath <path to the source public folder>

-TargetPath <path to the target public folder>

-CollectionId <public folder collection identifier, integer>

[-SimpleDisplayName ]

[-Alias ]

[-ProxyAddresses ]

[-PreservePrimarySMTP ]

[-Permissions ]

[-CustomAttributes]

Examples
Example 1
Get-MMExPublicFolderStatistics |Sort-Object -Property CollectionID | Sync-MMExMailPublicFolder -ProxyAddresses -Permissions

This command mail-enables target public folder, synchronizes proxy addresses and permissions of source mail-enabled publics folders.

Example 2
Sync-MMExMailPublicFolder -SourcePath "\PFScust25" -TargetPath "\PFScust25" -CollectionId 1 -ProxyAddresses -PreservePrimarySMTP -Permissions -Alias -SimpleDisplayName

This command synchronizes Active Directory properties of source mail-enabled public folder PFScust25 which belongs to collection with ID = 1, and target mail-enabled public folder PFScust25.

Parameters
 -SourcePath
        

Specifies path to the source mail-enabled public folder. This public folder properties will be synchronized as specified by the cmdlet. This action will be performed for the public folder only, sub-folder properties, if any, should be synchronized separately.

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

Specifies path to the target mail-enabled public folder. This public folder properties will be synchronized as specified by the cmdlet.

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

Specifies identifier of public folder collection. The CollectionId can be retrieved using Get-MMExPublicFolderStatistics cmdlet, or from the log file.

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

Specifies if simple display name will be synchronized.

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

Specifies if alias will be synchronized.

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

Specifies if proxy addresses will be synchronized.

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

IMPORTANT: To sync the source SMTP public folder address, you need to add a custom email domain as an accepted domain for your target Exchange organization.

-PreservePrimarySMTP

Specifies if target primary SMTP address will be preserved.

Required? false
Position? 6
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Permissions

Specifies if Send As and CanSendOnBehalfTo permissions will be synchronized.

Required? false
Position? 7
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CustomAttributes

Specifies if custom attributes 1-15 will be synchronized.

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

SourcePath

TargetPath

CollectionID

SimpleDisplayName

Alias

ProxyAddresses

PreservePrimarySMTP

Permissions

CustomAttributes

Suspend-MMExPublicFolderMigration

Suspends public folder migration.

Detailed Description

Suspends public folder migration.

To obtain a list of already suspended public folders, run cmdlet Get-MMExPublicFolderStatistics as follows:

Get-MMExPublicFolderStatistics | select FolderPath, DisplayName, IsSuspended.

Syntax

Suspend-MMExPublicFolderMigration

[-FolderId] <Int32>

[<CommonParameters>]

Examples

Example 1

Suspend-MMExPublicFolderMigration -FolderId 5

This command suspends migration of a public folder with identifier 5.

Migration was suspended for the following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1).

Example 2
Get-MMExPublicFolderStatistics -FolderPath "\PF_Root\PF1" | Suspend-MMExPublicFolderMigration

This command suspends migration of a public folder returned by Get-MMExPublicFolderStatistics cmdlet using path to the public folder.

Migration was suspended for the following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1).

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
Inputs

FolderID

Resume-MMExPublic FolderMigration

Resumes suspended migration

Detailed Description

The Resume-MMExPublic FolderMigration cmdlet resumes public folder migration for specified public folders. To obtain a list of already suspended public folders, run cmdlet Get-MMExPublicFolderStatistics as follows:

Get-MMExPublicFolderStatistics | select FolderPath,

DisplayName, IsSuspended.

Syntax

Resume-MMExPublicFolderMigration

[-FolderId] <Int32>

[<CommonParameters>]

Examples

Example 1

Resume-MMExPublicFolderMigration -FolderId 5

This command resumes suspended migration of a public folder with identifier 5.

Suspended migration was resumed for the following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1).

Example 2
Get-MMExPublicFolderStatistics -FolderPath "\PF_Root\PF1" | Resume-MMExPublicFolderMigration

This command resumes suspended migration of a public folder returned by Get-MMExPublicFolderStatistics cmdlet using path to the public folder.

Suspended migration was resumed for the following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1).

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
Inputs

FolderID

Remove-MMExPublicFolderMigration

This 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.

Detailed Description

The Remove-MMExPublicFolderMigration cmdlet 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.

Parameters

Caution: Stop Migration Agent for Exchange (MAgE) using Stop-MMExAgent before execute this command. After the command has been executed restart the agent using Start-MMExAgent to continue synchronization process for the rest of public folders.

Syntax

Remove-MMExPublicFolderMigration

-FolderId <Int32>

Examples
Example 1
Remove-MMExPublicFolderMigration -FolderId 5

The following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1) was temporarily removed from the migration project.

This command temporarily removes a public folder with identifier 5 from migration project.

Parameters
Example 2
PS C:\>Get-MMExPublicFolderStatistics -FolderPath "\PF_Root\PF1" | Remove-MMexPublicFolderMigration

The following public folder: '\PF_Root\PF1' (#5) from the collection 'Public Folder Collection (agenthost)' (#1) was temporarily removed from the migration project.

This command removes a public folder returned by Get-MMExPublicFolderStatistics cmdlet from migration project.

Parameters
            -FolderID
        

Specifies the identifier of a public folder to remove. Identifier could be retrieved using Get-MMExPublicFolderStatistics cmdlet or from the log file..

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

FolderID

관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택