Install Microsoft Dynamics CRM Server roles using the command prompt


Updated: December 9, 2016

Applies To: Dynamics 365 (on-premises), Dynamics CRM 2016

By default, Setup installs all Microsoft Dynamics CRM Server 2016 roles on the local computer. However, when you are installing Microsoft Dynamics CRM Server 2016, 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 365 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 365 Server role. For available server role names, see Microsoft Dynamics 365 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 365 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 365 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 365.


Installs the Deployment Web Service component that is required to manage the deployment by using the methods described in the Microsoft Dynamics 365 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 365 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