ExchangeMPConfig.exe Syntax

Applies To: Exchange Server, Operations Manager 2007

You can import and export configurations through the ExchangeMPConfig.exe tool.

To import and apply a configuration

  • Use the following command-line command:

    ExchangeMPConfig.exe /i <filename> [/u <domain\username> [/p <password>]]

    /i filename.xml – Sets configuration on user's servers based on the information in filename.xml.

  • Optional parameters used with /i are as follows:

    /u username – The user can use the /u parameter to specify the Mailbox Access Account. The user name will be in the DOMAIN\username format. The tool will validate this.

    /p password – The user can use the /p parameter to specify the password for the Mailbox Access Account. /u is required.

To export a configuration

  • Use the following command-line command:

    ExchangeMPConfig.exe /e <filename> [/s <serverFilter>] [/a <administrativeGroupFilter>]

    /e filename.xml – Creates a report named filename.xml that contains the configuration information of the selected servers. Filename.xml is the configuration file (configuration.xml) that is used with the /i parameter.

  • Optional parameters used with /e are as follows:

    • /s servername – Specifies the server from which to obtain the configuration file, instead of the default local computer. It can be used in combination with wildcard characters such as * and ?. Examine the usage output of the tool for more information.

    • /a admin group – Specifies the common name of an administrative group from which to obtain the configuration. If this parameter is set, the tool discovers all Exchange servers in the specified domain, obtains the configuration information from each server, and saves it to the configuration file. It can be used in combination with wildcard characters such as * and ?.

    • /? – Displays the valid command switches for the command, and gives a summary of what each does.

    Each parameter must be separated by a space from the value associated with the parameter. For example, /e configuration.xml is valid, but /e:configuration.xml, /e=configuration.xml, and /econfiguration.xml are not valid parameters.

The following table lists typical command lines that you can use to run ExchangeMPConfig.exe.

Note

Some commands in the following table have been displayed in multiple lines for better readability only. These should be entered in a single line.

Command Line

Description

ExchangeMPConfig.exe

This command runs the wizard in GUI mode.

ExchangeMPConfig.exe /i configuration.xml

This command imports the configuration specified in configuration.xml. An error is presented if the local computer does not have the Exchange System Manager tools installed or the current user does not have permissions to do the required configuration.

Because no Mailbox Access Account is specified on the command line, when the command executes, you are prompted for the Mailbox Access Account user name and password only if required by the configuration.

Note

The password field is not shown. As you type characters in the password, the command prompt pointer remains at the same location.

Output:

C:\> ExchangeMPConfig.exe /i configuration.xml

Mailbox Access Account Username (Domain\account): <name user entered>

Password:

Configuration Successful.

ExchangeMPConfig.exe /i configuration.xml /u ExDom\MailAcct

This command functions the same as ExchangeMPConfig.exe /i configuration.xml, but because the user name is provided, you are not prompted to enter a Mailbox Access Account interactively. However, you are still prompted for a Mailbox Access Account password only if necessary in the configuration.

Output:

C:\> ExchangeMPConfig.exe /i configuration.xml /u ExchDomain\MailAcct

Password:

ExchangeMPConfig.exe /i configuration.xml /u ExDom\MailAcct /p pass

This command performs the same action as the preceding command, but the Mailbox Access Account password is provided on the command line. The user is not prompted to interactively enter any information when using these parameters.

ExchangeMPConfig.exe /e report.xml

This command generates a configuration file that contains the current configuration information for all servers running Exchange. The file format is compliant with the format required for the /i parameter.

Output:

C:\> ExchangeMPConfig.exe /e report.xml

Generating configuration report for the local system. This operation may take several minutes.

ExchangeMPConfig.exe /e report.xml /s exch1

This command generates a configuration file. The system is specified with the /s parameter and the configuration of that system is retrieved instead of the local system. The listed server name can be the NetBIOS or FQDN name for the computer running Exchange.

In addition to addressing the errors listed in the previous command, the Exchange System Management Tools must be installed on the system where the configuration tool runs. If the tools are not on the local system, you will receive an error. Also, if the specified server cannot be contacted, you will receive an error. Only errors that are different from the above are listed here.

Output:

C:\> ExchangeMPConfig.exe /e

report.xml /s exch1

Generating configuration report for exch1. This operation may take several minutes.

ExchangeMPConfig.exe /e report.xml /a ExAG1

This command works similarly to the prepreceding two commands. It generates a configuration file for the domain specified with the /a parameter. All servers running Exchange and the Exchange Management Pack are queried for their current configuration. The administrative group name must be the common name of the administrative group.

Output:

C:\> ExchangeMPConfig.exe /e report.xml /a ExAG1

Generating configuration report for ExAG1. This operation may take several minutes.

ExchangeMPConfig.exe /?

This command displays the usage information for the executable. Usage information is also displayed if the user does not enter valid command-line parameters.