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

Restart-MMExAgent

Restarts an agent on the selected host.

Detailed Description

The Restart-MMExAgent cmdlet stops and then starts again the Migration Agent for Exchange (MAgE) installed on the selected host.

Syntax

Restart-MMExAgent

-Type PublicFolder

[-AgentHost <agent host name>]

[<CommonParameters>]

Examples

Restart-MMExAgent -Type PublicFolder

This command restarts the agent installed on the localhost.

Parameters

-Type
        

Specifies the agent type, currently only 'PublicFolder' is allowed.

 -AgentHost
        

Specifies host name where specified agent is installed to restart the agent.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, see about_CommonParameters.

Uninstall-MMExAgent

Uninstalls an agent from the selected host.

Detailed Description

The Uninstall-MMExAgent cmdlet uninstalls Migration Agent for Exchange (MAgE) installed on the selected host.

Syntax

Uninstall-MMExAgent

-Type PublicFolder

[-AgentHost <agent host name>]

[<CommonParameters>]

Examples

Uninstall-MMExAgent -Type PublicFolder

This command uninstalls the agent installed on the localhost.

Parameters

 -Type
        

Specifies the agent type, currently only 'PublicFolder' is allowed.

   -AgentHost
        

Specifies host name where specified agent is installed to uninstall the agent.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, see about_CommonParameters.

Granting Permissions

This section provides reference information on how to grant an administrative accounts the following required permissions:

Source Exchange 2010 Organization

• Granting the Public Folders Role
• Granting Read permission for public folders
• Granting Owner Permissions for Each Public Folder
• Granting Full Access Permission for Public Folder to an account

Source Exchange 2013/2016/2019 Organization

• Granting the Public Folders Role
• Granting Read permission for public folders
• Granting the View-Only Configuration Role
• Granting Owner Permissions for Each Public Folder
• Granting CreateSubfolders and FolderVisible Access Rights for the Root Folder

Target Exchange 2013/2016/2019 Organization

• Granting Read Permission to Microsoft Exchange Container
• Granting the Public Folders Role
• Granting the View-Only Configuration Role
• Granting Owner Permissions for Each Public Folder
• Granting CreateSubfolders and FolderVisible access rights to the root folder

Target Office 365 Organization

• Office 365 account: Granting the Public Folders Role
• Office 365 account: Granting the View-Only Configuration Role
• Office 365 account: Granting Public Folder Owner Permission
• Office 365 account: Granting CreateSubfolders and FolderVisible access rights

Granting Read Permission to Microsoft Exchange Container

To grant this permission to an account, perform the following:

1. From the Start menu, select Run. In the Run dialog box, type ADSIEdit.msc. Click OK.
2. In the ADSIEdit snap-in, open the CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=<…>,DC=<…> container.
3. Right-click the Microsoft Exchange container and select Properties.
4. In the Properties dialog box, click the Security tab.
5. On the Security tab, click Add to provide the account to which you wish to assign permissions.
6. Select the account name, and then enable the Allow option for the Read permission in the Permissions box.
7. Click the Advanced button. In the Advanced Security Settings dialog box, select the account you specified on step 5 and click Edit.
8. In the Permission Entry dialog box, select This object and all child (descendant) objects from the Apply onto drop-down list.
9. Click OK to accept changes.