Install Microsoft Dynamics CRM Server roles using the command prompt


Applies To: Dynamics CRM 2016

By default, Setup installs all Microsoft Dynamics CRM Server roles on the local computer. However, when you are installing Microsoft Dynamics CRM Server, you can select to install one or more server roles. Additionally, you can install the same server role or roles on two or more computers, which can provide load balancing benefits. To do this, you can either select the roles that you want by running the Microsoft Dynamics CRM Server Setup Wizard or you can configure an XML configuration file and then run Setup at a command prompt on the computer where you want the role installed.


You can run Setup at a command prompt or from Programs and Features in the Control Panel to add or remove server roles to a computer that already has one or more server roles installed.

For more information about server roles, see Microsoft Dynamics CRM server roles.

The supported command prompt parameters are the same as those previously described under Install Microsoft Dynamics CRM Server by using a command prompt in this guide.

The /config [drive:] [[path] configfilename.xml]] command-line parameter provides Microsoft Dynamics CRM Server Setup with required information. The information supplied by the XML configuration file is what is required by each installation screen.


The XML elements must be in English (US). An XML configuration file that has localized XML elements will not work correctly.

An explanation of each XML element and a sample XML file follows:

<Role Name="RoleName1" Action="Add" / "Remove"/>
<Role Name="RoleName2" Action="Add" / "Remove"/>

Name. The name of the Microsoft Dynamics CRM Server role. For available server role names, see Microsoft Dynamics CRM Server role names used in the XML configuration file.

Action. This attribute is only required when you reconfigure an existing deployment by adding or removing server roles.



Installs the components that are needed to run the Web application server.


Installs the Organization Web Service components that are needed to run applications that use the methods described in the Microsoft Dynamics CRM SDK.


Installs the Discovery Web Service component users need to find the organization that they are a member of in a multi-tenant deployment.


Installs the components that are needed to make Microsoft Dynamics CRM Help available to users.


Installs the Asynchronous Service. This service is used to process queued asynchronous events, such as bulk email or data import.


Installs the service and related files that handle sending and receiving of email messages by connecting to an external email server.


Installs the components that are needed to provide custom code execution isolation.


Installs Deployment Manager and Windows PowerShell cmdlets that you can use to automate deployment tasks. Deployment Manager is a Microsoft Management Console (MMC) snap-in that system administrators can use to manage organizations, servers, and licenses for deployments of Microsoft Dynamics CRM.


Installs the Deployment Web Service component that is required to manage the deployment by using the methods described in the Microsoft Dynamics CRM SDK, such as create an organization or remove a Deployment Administrator role from a user.


Installs the interface that can be used to back up and restore Microsoft Dynamics CRM data by using the Windows Server Volume Shadow Copy Service (VSS) infrastructure.


Although you cannot specify a group of server roles (Front End Server, Back End Server or Deployment Administration Server), you can specify all server roles in the server role group, such as the following XML sample snippet that installs all Front End Server roles.

<Role Name="WebApplicationServer" />
<Role Name="OrganizationWebService" />
<Role Name="DiscoveryWebService" />
<Role Name="HelpServer" />

© 2016 Microsoft. All rights reserved. Copyright

Community Additions