Sample server XML configuration file for installing with pre-created groups

This article doesn't apply to the Dynamics 365 Customer Engagement (on-premises), version 9.1 update. For information about new features in update 9.1, see What's new.

For information about this topic for Dynamics 365 Customer Engagement (on-premises), version 9.0, select the version located above the left navigation pane.

Version selector

By default, Setup creates four Active Directory security groups that are used by Dynamics 365 Customer Engagement (on-premises). You can create these groups in advance and then provide the information for the groups in the Setup configuration file.

To use the pre-created Active Directory directory service security groups, create an XML configuration file that uses the LDAP distinguished name syntax that is similar to the following example. Modify the variables as appropriate.

For example, the following sample would be used when the Organizational unit (OU) where the pre-created groups (PrivUserGroup, SQLAccessGroup, ReportingGroup, and PrivReportingGroup) are located is named CRM and the full domain name where the OU is located is sales.contoso.com.

Important

The user who runs Microsoft Dynamics 365 Server Setup must have Add User or Group permission to these Active Directory groups. For more information about how to assign user rights to a group in Active Directory Domain Services (AD DS), see the Active Directory Users and Computers Help.

Because the organizational unit will be specified when you use the Active Directory groups <GROUPS> element, you cannot specify the organizational unit again using the <OU> element.

The <Groups> element must be inside the <Server> and <CRMSetup> elements. For syntax structure, see Microsoft Dynamics 365 Server XML configuration file.

<Groups AutoGroupManagementOff="false">  
    <PrivUserGroup>CN=PrivUserGroup,OU=CRM,DC=sales,DC=contoso,DC=com</PrivUserGroup>  
    <SQLAccessGroup>CN=SQLAccessGroup,OU=CRM,DC=sales,DC=contoso,DC=com</SQLAccessGroup>  
    <ReportingGroup>CN=ReportingGroup,OU=CRM,DC=sales,DC=contoso,DC=com</ReportingGroup>  
    <PrivReportingGroup>CN=PrivReportingGroup,OU= CRM,DC=sales,DC=contoso,DC=com</PrivReportingGroup>  
</Groups>  

See Also

Microsoft Dynamics 365 Server XML configuration file
Install Microsoft Dynamics 365 Server roles using the command prompt