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