通过

Microsoft Dynamics CRM服务器 XML 配置文件

  • 项目

 

发布日期： 2017年1月

适用于： Dynamics 365 (on-premises),Dynamics CRM 2016

/config [drive:] [[path] configfilename.xml]] 命令行参数提供 Microsoft Dynamics CRM 服务器安装程序必需的信息。 各个安装屏幕都需要 XML 配置文件所提供的信息。

重要

XML 元素必须采用美国英语编写。 包含本地化的 XML 元素的 XML 配置文件将无法正常工作。 例如，如果您安装了德语版的 Microsoft Dynamics CRM，仍必须采用美国英语编写 XML 文件元素。

默认情况下，安装程序将使用 UTF-8 编码来读取安装程序的 XML 配置文件。 如果 XML 配置文件中存在扩展字符，安装程序将无法加载该文件。 此时，您会收到安装程序发出的一条错误消息，指出 XML 文件无效。 如果 XML 配置文件包含扩展字符，您可以通过使用“Unicode” 编码保存 XML 配置文件来解决该问题。 为此，请在 记事本 中打开 XML 配置文件，单击“另存为”，在“编码” 列表中选择“Unicode”，然后单击“保存”。

下面对各个 XML 元素进行解释，并给出完整服务器安装的一个示例 XML 文件。 有关如何使用命令提示符安装单独的服务器角色的信息，请参阅本指南中的使用命令提示符安装 Microsoft Dynamics CRM 服务器角色。

示例配置文件

  • <CRMSetup> </CRMSetup>
    配置文件必须是使用 <CRMSetup> 作为根元素的有效 XML 文件。
  • <Server> </Server>
    指定 Microsoft Dynamics CRM Server 2016安装。 随后的所有条目都必须位于 <Server> 元素内。

  • <InstallType>Uninstall/Repair/Configure</InstallType>
    指定安装程序将执行的安装类型。 可使用以下选项：

    • 卸载。 卸载 Microsoft Dynamics 365 服务器。

    • 修复。 以修复模式启动安装程序。

    • 配置。 在配置模式启动程序。

  • <Patch update="true"/"false">\\ServerName\ShareName\Patch_Location</Patch>
    确定更新 Microsoft Dynamics CRM 服务器安装程序技术的行为。 该功能允许安装程序执行一次性搜索，如果适用，将下载和应用 Microsoft Dynamics CRM 的最新安装文件。

    默认情况下，此元素不指定某个位置配置安装程序以通过使用 Microsoft 更新 搜索可用更新。 如果您想让安装程序从其他位置（如网络共享）安装更新，请将文件路径添加到该元素的 .msp 文件中，如以下主题所示。

    重要

    修补程序更新功能只能用于 安装 的更新，也称为自愈 安装。 不能用于应用应用程序更新，如 Microsoft Dynamics CRM 2016 Service Pack 1。

    更新

    指定安装程序是否查找、下载并应用更新 Microsoft Dynamics CRM 服务器安装程序。 建议您通过指定 true 让安装程序下载最新版本。 默认情况下，该值设置为 false。 如果该值设置为 false，安装程序将忽略此步骤，继续进行安装。 但是，如果使用 /Q 或 /QR 参数运行安装程序，您必须指定该元素。

  • <SqlServer>SQLServername\InstanceName</SqlServer>
    指定将管理数据库文件的 Microsoft SQL Server 实例的名称。 如果使用默认实例，则可以提供安装 SQL Server 的计算机的名称。 如果 SQL Server 在您正在安装的计算机上运行，您可以指定。 ”或者“localhost”。

  • <Database create="true"/"false" update="true"/"false"/>
    创建

    此参数的值可以是 true 也可以是 false。 如果为 True，将让安装程序创建一个新配置数据库。 如果为 False，将让安装程序连接到现有的配置数据库。

    更新

    此参数的值可以是 true 也可以是 false。 当您选择 true 时，安装程序会将相应的服务器部署信息写入配置数据库 (MSCRM_CONFIG)。 仅当您使用预先存在的配置数据库并且不希望安装程序更新服务器部署信息时，才选择 false。 当您选择 false 时，配置数据库中必须已存在要安装 Microsoft Dynamics CRM Server 2016 的计算机的相应服务器部署信息，安装程序才能成功完成安装。 默认值为 true。

  • <Organization>友好型组织或长名称</Organization>
    指定您所在组织的长名称。 该名称最多可以包含 250 个字符，并且支持扩展字符。

  • <OrganizationUniqueName>唯一名称</OrganizationUniqueName>
    UniqueName

    指定用户用来访问部署的 URL 中将使用的组织名称。 该名称最多可以包含 30 个字符。 不允许使用扩展字符或空格。 如果您不指定该元素或将其值保留为空，则安装程序会基于“<Organization>”元素值生成一个短名称。

    重要

    组织唯一名称将用于构造 URL 以便于用户登录到该应用程序。 因此，建议您限制组织唯一名称的长度，以减少 URL 的总长度。

  • <muoptin optin="true”/“false" />
    指定是否使用 Microsoft 更新 下载和安装 Microsoft Dynamics CRM Server 2016及其他已安装应用程序的更新。 安装完成后，此功能可帮助您将计算机始终保持最新状态。

    • True。 如果您指定此选项，安装程序将选择 Microsoft 更新 作为更新服务并使用计算机上的 Windows 自动更新设置。 可以在 控制面板 的 Windows Update 中查看 Windows 自动更新设置。Microsoft 更新 确保您的计算机应用了最新技术，以帮助降低漏洞和安全问题所带来的风险。

    • False。 如果指定此选项，安装程序不会更改现有 Windows 自动更新设置。 如果计算机尚未配置为使用 Microsoft 更新 作为更新服务，建议您通过其他方法在计算机上安装更新，例如通过使用 Windows Update Services。 如果保留为空，将选择值 false。

  • <OU> OU=value,DC=value,DC=value,DC=value,DC=value</OU>
    <OU> 元素指定将创建安全组的 Active Directory 部门，例如，<OU> OU=Dynamics CRM, DC=MySubDomain, DC=MyDomain, DC=com</OU>。

    重要

    您不能将 <Groups> 元素与 <OU> 元素一起使用。 如果同时指定这两个元素，安装程序将无法继续。

  • <PreferredDC>servername.domain.com</PreferredDC>
    指定执行需要 Active Directory 的操作时要联系的域控制器。 如果不指定，安装程序将使用第一个可用的域控制器。 仅当使用配置文件时，此设置才可用。

  • <LicenseKey>KeyValue</LicenseKey>
    指定此部署的产品密钥。 配置文件只能包含一个产品密钥。 例如：

    <licenseKey>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</licenseKey>

    备注

    如果通过 Microsoft 批量许可计划购买 Microsoft Dynamics 365，将在 license.txt 文件中提供生产密钥。 该 license.txt 文件包含在 Microsoft Dynamics CRM 安装文件中。

  • <WebsiteUrl Create="true"/"false" port="TCPportnumber">路径</WebsiteUrl>
    指定要用于应用程序的网站。 使用 Create="true" 可以创建新网站，并将元素标记之间的值保留为空。 使用 port="TCPportnumber"（其中 TCPportnumber 是一个有效且可用的 TCP 端口号）可指定用于连接到应用程序的端口。 如果保留为空，将使用端口号 5555。

    指定 Create="false" 可使用现有网站，随后您必须使用以下格式之一在元素标记中键入网站路径。 当您使用 Create="false" 属性时，将忽略端口属性。

    例如：

    • http://server:port/ 或 http:// server.contoso.com

    • /LM/W3SVC/n，其中 n 是网站 ID。1 是默认网站。

  • <Help anonymous="true"/"false">http://host/Help</Help>
    可选元素，用于指定 Microsoft Dynamics CRM帮助所在的其他 URL。 此设置通常用于多服务器部署或用于替换默认 URL（例如在使用主机头时）。 如果您选择 false 以禁用匿名访问，可能会为访问 帮助 的用户重复生成登录提示。 仅当使用配置文件时，此设置才可用。
  • <InstallDir>c:\program files\Microsoft Dynamics CRM</InstallDir>
    指定将在其中安装应用程序文件的文件夹。 默认情况下，安装程序将使用文件夹 C:\Program Files\Microsoft Dynamics CRM。

  • <basecurrency isocurrencycode="CurrencyCode" currencyname="CurrencyName" currencysymbol="CurrencySymbol" currencyprecision=”2"/"3"/"4”/>
    isocurrencycode

    指定用于基础货币的 ISO 三个字母货币代码、显示名称和符号。 例如，如果您要使用美元作为基础货币，可使用 isocurrencycode="USD"。 必须为 isocurrencycode 属性使用有效的 ISO 货币描述。

    currencyname 和 currencysymbol

    还必须为 ISO 基础货币指定货币名称和货币符号显示名称。 例如，如果 ISO 货币代码为 USD，则货币名称应为“US Dollar”，货币符号应为“$”。 但您也可以根据需要对这些属性使用任意字符串。

    重要

    安装程序完成安装后，您将无法更改基本 ISO 货币代码。 但可以更改基础货币名称、基础货币符号和基础货币精度。

    货币代码根据 Microsoft .NET Framework 提供，并且可能会更改。

    currencyprecision

    您必须为 currencycode 属性中指定的基础货币指定精度。 有效值取决于您指定的货币类型。 例如，USD 的有效值为 1 – 9，默认值为 2。

  • <OrganizationCollation>CollationName</OrganizationCollation>
    该可选元素指定用于组织数据库的 SQL Server 数据库排序规则名称。 默认排序规则取决于您所安装的 Microsoft Dynamics CRM 的语言，例如，Latin1_General_Cl_Al 是美国英语部署的默认排序规则。 有关数据库排序规则的详细信息，请参阅 MSDN：使用 SQL Server 排序规则。

  • <CrmServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>Domain\User</ServiceAccountLogin>
    <ServiceAccountPassword>password</ServiceAccountPassword>
    </CrmServiceAccount>
    指定用于运行 Microsoft Dynamics 365 解压缩服务和 ASP.NET AppPool 应用程序池标识的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户或该值将使用 NetworkService 元素中指定的网络服务系统帐户）。 但是，并不推荐使用网络服务系统帐户，因其可能限制一些数据库操作，如组织的创建、导入、升级或更新。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“<ServiceAccountPassword>”。 当您使用 /Q 或 /QR 参数运行安装程序时，若没有指定此元素，则将使用网络服务账号。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

    强烈建议您选择专门用于运行这些服务而不用于任何其他目的的低特权域帐户。 此外，用于运行 Microsoft Dynamics 365 服务的用户帐户不能是 Microsoft Dynamics 365 用户。 此域帐户必须是域用户组的成员。 此外，如果 异步服务 和 沙盒处理服务 角色已安装，比如在完全服务器或 后端服务器 安装中，则域帐户必须是 Performance Log Users 安全组的成员。

  • <SandboxServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>Domain\User</ServiceAccountLogin>
    <ServiceAccountPassword>密码</ServiceAccountPassword>
    </SandboxServiceAccount>
    指定用于沙盒处理服务的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户）或 NetworkService（该值将使用网络服务系统帐户）。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“ServiceAccountPassword”<>。 当您使用 /Q 或 /QR 参数运行安装程序时，若没有指定此元素，则将使用网络服务账号。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

    如果不指定此元素，安装程序将使用“CrmServiceAccount”元素中指定的帐户运行此服务。 因此，建议您为每个服务帐户指定不同的低特权用户帐户。

  • <DeploymentServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>Domain\User</ServiceAccountLogin>
    <ServiceAccountPassword>密码</ServiceAccountPassword>
    <DeploymentServiceAccount>
    指定用于部署 Web 服务的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户）或 NetworkService（该值将使用网络服务系统帐户）。 但是，并不推荐使用网络服务系统帐户，因其可能限制一些数据库操作，如组织的创建、导入、升级或更新。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“<ServiceAccountPassword>”。 当您使用 /Q 或 /QR 参数运行安装程序时，若没有指定此元素，则将使用网络服务账号。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。 如果不指定此元素，安装程序将使用“CrmServiceAccount”元素中指定的帐户运行此服务。 因此，建议您为每个服务帐户指定不同的低特权用户帐户。 除其他服务帐户所需的权限之外，部署 Web 服务 帐户还需要 SQL Server 的系统管理员权限，并且必须是运行 SQL Server 的本地管理员组的成员才能创建或导入组织。

    重要

    要通过部署 Web 服务或 Windows PowerShell 执行组织操作，部署服务帐户必须拥有运行 SQL Server 的计算机的系统管理员权限，并且必须是安装 SQL Server 的本地管理员组的成员。 此外，执行组织操作的用户还应该是部署管理员。

    部署管理员 角色是在 部署管理器 中设置的。

  • <AsyncServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>Domain\User</ServiceAccountLogin>
    <ServiceAccountPassword>密码</ServiceAccountPassword>
    <AsyncServiceAccount>
    指定用于异步处理服务的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户）或 NetworkService（该值将使用网络服务系统帐户）。 但是，并不推荐使用网络服务系统帐户，因其可能限制一些数据库操作，如组织的创建、导入、升级或更新。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“<ServiceAccountPassword>”。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

    如果不指定此元素，安装程序将使用“CrmServiceAccount”元素中指定的帐户运行此服务。 因此，建议您为每个服务帐户指定不同的低特权用户帐户。

  • <VSSWriterServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>= " DomainUser”/“NetworkService " </ServiceAccountLogin>
    <ServiceAccountPassword>密码</ServiceAccountPassword>
    </VSSWriterServiceAccount>
    指定用于 Microsoft Dynamics 365 VSS 编写器服务的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户）或 NetworkService（该值将使用网络服务系统帐户）。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“<ServiceAccountPassword>”。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

    建议您为每个服务帐户指定不同的低特权用户帐户。

  • <MonitoringServiceAccount type="DomainUser"/"NetworkService">
    <ServiceAccountLogin>= " DomainUser”/“NetworkService " </ServiceAccountLogin>
    <ServiceAccountPassword>密码</ServiceAccountPassword>
    </MonitoringServiceAccount>
    指定用于 Microsoft Dynamics 365 监视服务的服务帐户。

    可接受的值为 DomainUser（该值将使用在 <prefixServiceAccount> 元素中指定的域用户）或 NetworkService（该值将使用网络服务系统帐户）。 默认情况下，安装程序使用 DomainUser 选项。 如果指定 DomainUser 或不指定任何类型，则必须提供“<ServiceAccountLogin>”和“<ServiceAccountPassword>”。

    警告

    维护指定了“ServiceAccountLogin”<>和“ServiceAccountPassword”<>值的配置文件存在安全风险，因为您是以纯文本格式存储密码的。 在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

    建议您为每个服务帐户指定不同的低权限用户帐户。

    有关 Microsoft Dynamics 365服务的信息，请参阅 Microsoft Dynamics 365 服务器角色。 有关执行 Microsoft Dynamics 365 服务所需权限的信息，以及使用什么类型的客户，请参阅的 Microsoft Dynamics 365 的安全注意事项。

  • <SQM optin=" true / false"/>
    指定您是否愿意参与“客户体验改善计划”。 如果指定“true”，表示您愿意参与该计划。

    备注

    有关详细信息，请参阅 Microsoft 客户体验改善计划。

  • <Reporting URL="http://srsserver1/ReportServer"/>
    URL

    指定报表服务器的 URL。

  • <Groups autogroupmanagementoff="true/false">
    <PrivUserGroup>CN=value,OU=value,DC=value,DC=value,DC=value</PrivUserGroup>
    <SQLAccessGroup>CN=value,OU=value,DC=value,DC=value,DC=value</SQLAccessGroup>
    <ReportingGroup>CN=value,OU=value,DC=value,DC=value,DC=value</ReportingGroup>
    <PrivReportingGroup>CN=value,OU=value,DC=value,DC=value,DC=value</PrivReportingGroup>
    </Groups>
    一旦指定，安装程序将使用 Active Directory 中现有的组，而不是在安装过程中创建组。 如果“<automanagegroupsoff>” 的值为“true”，安装程序将不会在这些组中添加或移除任何成员。 如果将“automanagegroupsof<> 的值指定为“true”，则必须手动创建相应的成员关系并将其添加到这些组，用户才能运行此应用程序，在 Microsoft Dynamics 365 中添加新成员或移除成员时也必须这么做。

    重要

    • 您不能将“<Groups>” 元素与“<OU>”元素一起使用。 如果同时指定这两个元素，安装程序将无法继续。

    • 必须要有 Microsoft Dynamics CRM privusergroup 安全组内的直接用户帐户成员资格，并且当前不支持在 privusergroup 下嵌套组成员资格。 通过其他安全组授予针对 privusergroup 的成员资格会在整个系统范围内导致 CRM Web 应用程序和报告功能故障。 例如，如果向 privusergroup 添加名为 mycrmprivgroupusers 的安全组，则 mycrmprivgroupusers 的成员将不会解析为 privusergroup 成员。 这包括 CRMAppPool 或 SQL Server Reporting Services 服务标识。

    仅当使用配置文件时，此设置才可用。

  • <remoteinstall>"true" / "false" </remoteinstall>
    当您使用 Windows PowerShell 远程运行远程安装时需要此选项。 默认值为 false。

  • <Reboot>"true" / "false"</Reboot>
    如果未指定此选项，则默认值为 false。 这意味着，安装程序结束时服务器不会自动重新启动。 此外，该选项仅适用于安装过程最后的重新启动，而不适用于之前其他组件可能必需的重新启动。

    备注

    安装 Microsoft .NET Framework 可能需要重新启动计算机，然后才能继续运行 Microsoft Dynamics CRM 服务器安装程序。

  • <Email>
    <IncomingExchangeServer name="ServerName"/>
    该可选元素指定用于 电子邮件路由器 传入电子邮件的 Microsoft Exchange Server 计算机或 POP3。 如果未指定并且以后要在部署中使用 电子邮件路由器，则必须将此计算机添加到“PrivUserGroup” 安全组。
  • </Email>
    指定将用于路由电子邮件的电子邮件服务器。

  • <configdb>
    它是以下加密密钥元素的上级元素：

    警告

    默认情况下，加密密钥不会以加密格式存储在配置数据库中。 强烈建议您在运行安装程序时使用以下项指定加密。

  • <encryptionkeys certificate="CrmEncryptionCertificate" generate="true"/"False" password="SCpassword" keysource="uniqueID">
    “加密”<>元素指定如何以及是否对存储在 Microsoft Dynamics 365 系统中的密钥进行加密。 使用 generate="true" 可启用系统生成的加密密钥。keysource 可以是任何值，但必须与其他 keysource 值不同。SCpassword 是用于创建对称证书的密码。 仅当使用配置文件时，此设置才可用。

    警告

    维护指定 password 和 keysource 值的配置文件具有一定的安全风险，因为您以纯文本格式存储密码和密钥信息。 建议您将密码保存到安全的位置，以后可以从该位置找回密码进行恢复。 有关密码存储的最佳做法的详细信息，请参阅 MSDN 文章：密码最佳做法。 然后，在使用配置文件安装 Microsoft Dynamics CRM Server 2016 后立即删除这些元素。

  • <encryptionkey physicalname="CrmSymmetricKey" virtualname="CrmKeyEncryptionKey"/>
    每个“encryptionkeys”<> 元素都指定一个 Microsoft SQL Server 数据库中的对称密钥存储和虚拟密钥名称（在 Microsoft Dynamics 365 中是为配置数据库中的加密数据进行编码的）之间的映射。 仅当使用配置文件时，此设置才可用。
  • </encryptionkeys>
    </configdb>

  • <LaunchReportingExtensionsSetup>"false" / "true"</LaunchReportingExtensionsSetup>
    用于指定是否在 Microsoft Dynamics CRM 服务器安装程序完成后立即启动 Microsoft Dynamics CRM Reporting Extensions 安装程序的可选元素。 默认情况下，此元素的值为 false，Microsoft Dynamics CRM Reporting Extensions 安装程序 不会在 Microsoft Dynamics CRM 服务器安装程序 完成后启动。 此外，Microsoft Dynamics CRM Reporting Extensions 安装程序仅在满足以下条件时才启动：

    • Microsoft Dynamics CRM 服务器安装程序将要创建或升级部署中的第一个组织

    • 指定的 报表服务器 计算机是运行安装程序的本地计算机。

另请参阅

使用命令提示符安装 Microsoft Dynamics Server 365
示例服务器 XML 配置文件
用于使用预先创建的组安装的示例服务器 XML 配置文件

© 2017 Microsoft。 保留所有权利。 版权