Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

PowerProtect Data Manager 19.15 Microsoft Exchange Server User Guide

Install the Microsoft application agent with a silent installation

Learn how to install the Microsoft application agent (including the agent service) with the command prompt for a silent installation.

To silently install the Microsoft application agent (including the agent service), run the following command:

emcmsappagent-19.15.0.0.exe -silent -log "<log_file_path>" [ProductInstallPath="<installation_path>"] [InstallPPDMAgentCheckBox={0|1}] [EnableFirewallRules={0|1}] [PPDMHostname="<hostname/IP>"] [EnableItemPoint={0|1}] [ClientPort=<port_number>] [PreferredAddress="<agent_hostname/IP>"]

The following table describes the required silent installation command options.

Table 1. Required silent installation command optionsTable of required silent installation command options
Command option Description
-silent Specifies a silent installation.
-log "<log_file_path>" Specifies the path where the log file is created or saved. The log file displays the status of the installation. For a silent installation, you must use the -log "<log_file_path>" option.

The following table describes the optional silent installation command options.

Table 2. Optional silent installation command optionsTable of optional silent installation command options
Command option Description
ProductInstallPath="<installation_path>" Specifies a modified path where the product and agent service must be installed. This option must be specified for an installation to a custom location. If you do not specify this option, the product and agent service are installed in the default location.
InstallPPDMAgentCheckBox={0|1} Integrates the Microsoft application agent with the PowerProtect Data Manager server during installation when you specify the value 1. The default value is 0. The agent service is always installed, regardless of the InstallPPDMAgentCheckBox command option setting.
NOTE:Installation of the Microsoft application agent requires the port specified by ClientPort (port 7000 by default) to be open bidirectionally. Ensure that you use the EnableFirewallRules=1 command option setting to open the Windows firewall. The ClientPort port or default port 7000 is required to enable communication between the Microsoft application agent and the PowerProtect Data Manager server.
EnableFirewallRules={0|1} Specifies to configure the Windows firewall when you specify the value 1. The default value is 0. The Windows firewall enables the bidirectional inbound and outbound connections for the agent service over the port specified by ClientPort, which enables the communication between the Microsoft application agent and PowerProtect Data Manager.
PPDMHostname="<hostname/IP>" Specifies the hostname or IP address of the PowerProtect Data Manager server where the backup information is reported.
EnableItemPoint={0|1} Specifies whether to install ItemPoint. To enable granular-level restores, install ItemPoint with the Microsoft application agent by setting this option value to 1. The default option value is 0.
ClientPort=<port_number> Specifies the port on Microsoft Exchange Server from the supported port ranges 7000 to 7009 and 7012 to 7020. This specified port and the port 8443 on PowerProtect Data Manager enable the communication between the Microsoft application agent and PowerProtect Data Manager, and both ports are open bidirectionally.
NOTE:If you do not specify a port number, the default port 7000 is used as the communications port. The ports 7010 and 7011 are used by the agent service message bus.

The ClientPort option is not supported for a silent update. A  silent update uses the previously configured port number and disregards any ClientPort option setting.

PreferredAddress="<agent_hostname/IP>" Specifies the address of the application agent host to be used for communication between the Microsoft application agent and PowerProtect Data Manager. The preferred host address can be an IPv4 address, an IPv6 address, or a fully qualified domain name (FQDN).
NOTE:If the preferred address is an FQDN, ensure that lookup is enabled in the PowerProtect Data Manager UI. If lookup is not enabled, the preferred address defaults to an IP address.

Example commands to silently install the Microsoft application agent

Consider the following example commands to silently install the Microsoft application agent (including the agent service):

  • The following command installs the Microsoft application agent by using the default installation pathname:
    NOTE:The specified log file value "integration.txt" generates the logs at the current installer location.
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt"
  • The following command installs the Microsoft application agent by using the custom installation pathname:
    emcmsappagent-19.15.0.0.exe -silent -log "<custom_pathname>" ProductInstallPath="<custom_pathname>"
  • The following command installs the Microsoft application agent with ItemPoint:
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt" EnableItemPoint=1
  • The following command installs the Microsoft application agent with PowerProtect Data Manager and ItemPoint by using the default agent host address (Ethernet address) and default port 7000:
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt" InstallPPDMAgentCheckBox=1 EnableFirewallRules=1 PPDMHostname="10.125.34.161" EnableItemPoint=1
  • The following command installs the Microsoft application agent with PowerProtect Data Manager and ItemPoint by using the preferred agent host address as an IPv4 and the specified port 7005:
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt" InstallPPDMAgentCheckBox=1 EnableFirewallRules=1 PPDMHostname="10.125.34.161" EnableItemPoint=1 PreferredAddress="10.125.34.202" ClientPort=7005
  • The following command installs the Microsoft application agent with PowerProtect Data Manager and ItemPoint by using the preferred agent host address as an IPv6 and the specified port 7007:
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt" InstallPPDMAgentCheckBox=1 EnableFirewallRules=1 PPDMHostname="10.125.34.161" EnableItemPoint=1 PreferredAddress="3ffe:80c0:22c:8066:5000" ClientPort=7007
  • The following command installs the Microsoft application agent with PowerProtect Data Manager and ItemPoint by using the preferred agent host address as an FQDN and the specified port 7004:
    emcmsappagent-19.15.0.0.exe -silent -log "integration.txt" InstallPPDMAgentCheckBox=1 EnableFirewallRules=1 PPDMHostname="10.125.34.161" EnableItemPoint=1 PreferredAddress="win.exch.app.com" ClientPort=7004

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\