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.
| Required? | true |
| Position? | 2 |
| Default value | PublicFolder |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
-AgentHost
Specifies host name where specified agent is installed to restart the agent.
|
|
TIP: If this parameter is not specified, the agent will be restarted on the local server (localhost).. |
| Required? | false |
| Position? | 1 |
| Default value | <localhost> |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
<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.
| Required? | true |
| Position? | 2 |
| Default value | PublicFolder |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
-AgentHost
Specifies host name where specified agent is installed to uninstall the agent.
|
|
TIP: If this parameter is not specified, the agent will be uninstalled from the local server (localhost). |
| Required? | false |
| Position? | 1 |
| Default value | <localhost> |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
<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:
- From the Start menu, select Run. In the Run dialog box, type ADSIEdit.msc. Click OK.
- In the ADSIEdit snap-in, open the CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=<…>,DC=<…> container.
- Right-click the Microsoft Exchange container and select Properties.
- In the Properties dialog box, click the Security tab.
- On the Security tab, click Add to provide the account to which you wish to assign permissions.
- Select the account name, and then enable the Allow option for the Read permission in the Permissions box.
- Click the Advanced button. In the Advanced Security Settings dialog box, select the account you specified on step 5 and click Edit.
- In the Permission Entry dialog box, select This object and all child (descendant) objects from the Apply onto drop-down list.
- Click OK to accept changes.