Microsoft Dynamics 365 Server XML 設定檔

發行項
12/13/2024

本文不適用於 Dynamics 365 Customer Engagement (on-premises) 9.1 版更新。有關 9.1 版更新中的新功能資訊，請參閱最新功能。

有關 Dynamics 365 Customer Engagement (on-premises) 9.0 版的此主題資訊，請選擇位於左導航窗格上方的版本。

/config [drive:] [[path] configfilename.xml]] 命令列參數為 Microsoft Dynamics 365 Server 安裝程式提供所需的資訊。 XML 設定檔提供的資訊與每一個安裝畫面要求的資訊相同。

重要

XML 元素必須為英文 (美國)。具有當地語系化 XML 元素的 XML 設定檔將無法正確運作。例如，如果您擁有德文版的 Microsoft Dynamics CRM，則 XML 檔案元素必須仍為英文 (美國)。

根據預設值，安裝程式會為安裝程式 XML 設定檔使用 UTF-8 編碼。當檔案存在擴充的字元時，安裝程式無法載入 XML 設定檔。您將收到安裝程式傳送的錯誤訊息，告知 XML 檔案無效。如果 XML 設定檔包含擴充字元，您可以使用 Unicode 編碼來儲存 XML 設定檔，便可以解決此問題。若要這樣做，使用記事本開啟 XML 設定檔、選取另存新檔、選取編碼清單中的 Unicode，然後選取儲存。

每個 XML 元素的說明及完整伺服器安裝的 XML 檔案範例如下。如需如何使用命令提示字元來安裝個別伺服器角色的相關資訊，請參閱本指南的安裝 Microsoft Dynamics 365 Server 角色。

設定檔偏好設定

<CRMSetup></CRMSetup>
設定檔必須是有效的 XML 檔，並使用 <CRMSetup> 做為根元素。

<Server></Server>
指定 Dynamics 365 Server 安裝。後續的所有元素都必須位於 <Server> 元素內部。

<InstallType>解除安裝/修復/設定</InstallType>
指定安裝程式將執行的安裝類型。下列是可用的選項：

解除安裝。解除安裝 Dynamics 365 Server。
修復。以修復模式啟動安裝程式。
設定。在設定模式中啟動安裝。

<Patch update="true"/"false">\\ServerName\ShareName\Patch_Location</Patch>
決定更新 Microsoft Dynamics 365 Server 安裝程式技術的行為。此功能可讓安裝程式 Dynamics 365 Customer Engagement (on-premises)執行單次搜尋，並且視需要下載，以套用的最新安裝檔案。

根據預設，此元素不指定位置，而會設定安裝程式要使用 Microsoft Update 來搜尋可用的更新。如果您想要從其他位置安裝更新 (例如網路上的共用)，請將檔案路徑新增至元素中的 .msp 檔案，如下列主題中所示。

重要

修補程式更新功能只能用於更新安裝程式，也稱為自我修復安裝程式。這無法用來套用應用程式更新。其他資訊：更新 Microsoft Dynamics 365

update

指定安裝程式是否要尋找、下載並套用 Microsoft Dynamics 365 Server 安裝程式的更新。我們建議您藉由指定 true，讓安裝程式下載最新版本。根據預設，此值會設定為 false。若值設為 false，則安裝程式將會忽略此步驟，並繼續安裝。但是，如果您使用 /Q 或 /QR 參數來執行安裝程式，您必須指定此元素。

<SqlServer>SQLServername\InstanceName</SqlServer>
指定 SQL Server 執行個體的名稱，將用來管理資料庫檔案。如果您使用預設的執行個體，可提供安裝 SQL Server 的電腦名稱。如果 SQL Server 在您要安裝的電腦上執行，您可以指定 ". " 或 "localhost"。

<Database create="true"/"false" update="true"/"false"/>
create

此參數的值是 true 或 false。 True 會導致安裝程式建立新的設定資料庫。 False 則會導致安裝程式連線至現有的設定資料庫。

update

此參數的值是 true 或 false。當您選取 true 時，安裝程式會將適當的伺服器部署資訊寫入設定資料庫 (MSCRM_CONFIG)。唯有當您使用既存的設定資料庫，而且不想讓安裝程式更新伺服器部署資訊時才能選取 false。當您選取 false 時，將安裝 Dynamics 365 Server 之電腦的適當伺服器部署資訊必須已經存在於設定資料庫中，才能順利完成安裝程式。預設值是 true。

<Organization>組織易記名稱或完整名稱</Organization>
指定組織的完整名稱。名稱最長可以是 250 個字元，而且支援擴充字元。

<OrganizationUniqueName>唯一名稱</OrganizationUniqueName>
UniqueName

指定使用者將用來存取部署之 URL 中使用的組織名稱。不可以超過 30 個字元。不允許擴充字元或空格。如果您未指定此元素或讓此值空白，安裝程式將根據 <Organization> 元素值來產生簡短名稱。

重要

獨特的組織名稱將用來建構 URL，讓使用者可用以登入應用程式。因此，我們建議您限制獨特組織名稱的長度，以減少整個 URL 的長度。

<muoptin optin="true”/“false" />
指定是否使用 Microsoft Update 下載和安裝 Dynamics 365 Server 及其他所安裝應用程式的更新。安裝完成後，此功能將持續維持電腦保持最新狀態。

True。指定此選項時，安裝程式將會選擇加入 Microsoft Update 做為更新服務，並且在電腦上使用 Windows 自動更新設定。 Windows 自動更新設定可在控制台的 Windows Update 中檢視。 Microsoft Update 可確保您的電腦擁有最新的技術，有助於降低弱點與安全性問題的風險。
False。指定此選項時，安裝程式將不會變更現有 Windows 自動更新設定。如果尚未設定電腦使用 Microsoft Update 做為更新服務，建議您以其他方法在電腦上安裝更新，例如使用 Windows Update Services。如果保留空白，將選取 false 的值。

<OU> OU=value,DC=value,DC=value,DC=value,DC=value</OU>
<OU> 元素會指定要在其中建立安全性群組的 Active Directory 組織單元要 (OU)，例如 <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 大量授權方案購買 Dynamics 365 Customer Engagement (on-premises)，則產品金鑰位於 license.txt 檔案中。 License.txt 檔案隨附於 Dynamics 365 Customer Engagement (on-premises) 安裝檔案中。

<WebsiteUrl Create="true"/"false" port="TCPportnumber">path</WebsiteUrl>
指定要用於應用程式的網站。使用 Create="true" 建立新網站，元素標記之間的值保留空白。使用 port="TCPportnumber" (其中 TCPportnumber 是有效且可用的 TCP 通訊埠號碼) 指定與應用程式連接的連接埠。如果空白，則會使用的連接埠號碼 5555。

指定 Create="false" 來使用現有的網站，然後您必須使用下列其中一種格式，在元素標記中輸入網站路徑。當您使用 Create="false" 屬性時，即會忽略連接埠屬性。

例如：

https://server:port/ or https:// server.contoso.com
/LM/W3SVC/n，其中 n 是網站識別碼。1 是預設網站。

<Help anonymous="true"/"false">https://host/Help</Help>
選用元素，可指定 Dynamics 365 Customer Engagement (on-premises) 說明所在位置的其他 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 資料庫定序名稱，以供組織資料庫使用。預設定序會根據您正在安裝的 Dynamics 365 Customer Engagement (on-premises) 語言而定，例如，Latin1_General_Cl_Al，此為英文 (美國) 語言部署的預設定序。如需資料庫定序的詳細資訊，請參閱定序和 Unicode 支援。

<CrmServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
</CrmServiceAccount>
指定用來執行 ASP.NET 解壓縮服務以及 Dynamics 365 Customer Engagement (on-premises) AppPool 應用程式集區識別的服務帳戶。

接受的值為 DomainUser，這將使用 <prefixServiceAccount> 元素或 NetworkService 中提供的特定網域使用者，這將使用網路服務系統帳戶。但不建議使用網路服務系統帳戶，因為它可能會限制像是組織建立、匯入、升級或更新等部分資料庫操作。根據預設，安裝程式將使用 DomainUser 選項。如果指定 DomainUser 或未指定任何類型，則需要 <ServiceAccountLogin> 和 <ServiceAccountPassword>。當您使用 /Q 或 /QR 參數執行安裝程式時，如果未指定此元素，將會使用網路服務帳戶。

警告

維護已指定 <ServiceAccountLogin> 和 <ServiceAccountPassword> 值的設定檔具有安全性風險，因為密碼是以純文字儲存。使用設定檔安裝 Dynamics 365 Server 之後，盡快刪除這些元素。

強烈建議您選取一個低權限的網域帳戶，專門用來執行這些服務，而且不要用於其他用途。此外，用來執行 Dynamics 365 Customer Engagement (on-premises) 服務的使用者帳戶，不可以是 Dynamics 365 Customer Engagement (on-premises) 使用者。這個網域帳戶必須是「網域使用者」群組的成員。另外，如果已安裝非同步服務與沙箱處理服務角色 (例如在完整伺服器或後端伺服器安裝中)，則網域帳戶必須是「效能記錄使用者」安全性群組的成員。

<SandboxServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
</SandboxServiceAccount>
指定要用於沙箱處理服務的服務帳戶。

接受的值為 DomainUser，這將使用 <prefixServiceAccount> 元素或 NetworkService 中提供的特定網域使用者，這將使用網路服務系統帳戶。根據預設，安裝程式將使用 DomainUser 選項。如果指定 DomainUser 或未指定任何類型，則需要 <ServiceAccountLogin> 和 <ServiceAccountPassword>。當您使用 /Q 或 /QR 參數執行安裝程式時，如果未指定此元素，將會使用網路服務帳戶。

警告

如果您未指定此元素，安裝程式將使用 <CrmServiceAccount> 元素中指定的帳戶來執行此服務。因此，我們建議您針對每個服務帳戶指定其他權限較低的使用者帳戶。

<DeploymentServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
<DeploymentServiceAccount>
指定要用於部署 Web 服務的服務帳戶。

接受的值為 DomainUser，這將使用 <prefixServiceAccount> 元素或 NetworkService 中提供的特定網域使用者，這將使用網路服務系統帳戶。但不建議使用網路服務系統帳戶，因為它可能會限制像是組織建立、匯入、升級或更新等部分資料庫操作。根據預設，安裝程式將使用 DomainUser 選項。如果指定 [DomainUser] 或未指定任何類型，則需要 <ServiceAccountLogin> 和 <ServiceAccountPassword>。當您使用 /Q 或 /QR 參數執行安裝程式時，如果未指定此元素，將會使用網路服務帳戶。

注意

維護已指定 <ServiceAccountLogin> 和 <ServiceAccountPassword> 值的設定檔具有安全性風險，因為密碼是以純文字儲存。使用設定檔安裝 Dynamics 365 Server 之後，盡快刪除這些元素。如果您未指定此元素，安裝程式將使用 <CrmServiceAccount> 元素中指定的帳戶來執行此服務。因此，我們建議您針對每個服務帳戶指定其他權限較低的使用者帳戶。除了其他服務帳戶所需的權限之外，部署 Web 服務帳戶還需要 SQL Server 上的系統管理員權限，而且必須是正在執行 SQL Server 的本機系統管理員群組成員，才能建立或匯入組織。

重要

若要透過部署 Web 服務或 Windows PowerShell 執行組織作業，部署服務帳戶必須在執行 SQL Server 的電腦上擁有系統管理員權限，並且必須是安裝 SQL Server 的本機系統管理員群組成員。此外，執行組織作業的使用者也必須是部署系統管理員。

您可以在部署管理員中授與部署系統管理員角色。

< AsyncServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
<AsyncServiceAccount>
指定可供非同步處理服務使用的服務帳戶。

接受的值為 DomainUser，這將使用 <prefixServiceAccount> 元素或 NetworkService 中提供的特定網域使用者，這將使用網路服務系統帳戶。但不建議使用網路服務系統帳戶，因為它可能會限制像是組織建立、匯入、升級或更新等部分資料庫操作。根據預設，安裝程式將使用 DomainUser 選項。如果指定 DomainUser 或未指定任何類型，則需要 <ServiceAccountLogin> 和 <ServiceAccountPassword>。

警告

<VSSWriterServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>="DomainUser"/"NetworkService"</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
</VSSWriterServiceAccount>
指定可供 Dynamics 365 Customer Engagement (on-premises) VSS 寫入器服務使用的服務帳戶。.

警告

我們建議您針對每個服務帳戶指定其他權限較低的使用者帳戶。

<MonitoringServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>="DomainUser"/"NetworkService"</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
</MonitoringServiceAccount>
指定可供 Dynamics 365 Customer Engagement (on-premises) 監控服務使用的服務帳戶。.

警告

我們建議您針對每個服務帳戶指定其他權限較低的使用者帳戶。

如需 Dynamics 365 Customer Engagement (on-premises) 服務的詳細資訊，請參閱 Microsoft Dynamics 365 Server 角色。如需 Dynamics 365 Customer Engagement (on-premises) 服務所需權限的資訊，以及使用哪些類型的帳戶，請參閱 Dynamics 365 安全性考量。

<SQM optin=" true / false"/>
指定是否參與「客戶經驗改進計畫」。如果您指定為 true，將會參與此方案。

<Reporting URL="https://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，安裝程式便不會將任何成員新增至這些群組或從中移除任何成員。如果您將 <automanagegroupsoff> 指定為 true，則必須手動建立適當的成員資格並將其新增至這些群組，讓使用者可以執行應用程式，而且您必須在從 Dynamics 365 Customer Engagement (on-premises) 新增或移除新成員時繼續執行此動作。

重要

您在使用 <Groups> 元素時，無法搭配 <OU> 元素。如果您同時指定兩個元素，安裝程式將不會繼續。
需要 Microsoft Dynamics 365 privusergroup 安全性群組的直接使用者帳戶成員資格，而且目前不支援 privusergroup 底下的群組成員資格巢狀化。透過另一個安全性群組對 privusergroup 授與成員資格，可能會導致 Web 應用程式和報表功能發生全系統故障的情形。例如，如果您將名為 mycrmprivgroupusers 的安全性群組新增至 privusergroup，mycrmprivgroupusers 的成員將不會解析為 privusergroup 成員。這包括 CRMAppPool 或 SQL Server Reporting Services 服務身分識別。

唯有當您使用設定檔時才可使用此設定。

<remoteinstall>"true" / "false" </remoteinstall>
這是您使用 Windows PowerShell 遠端處理執行遠端安裝時所需的選項。預設值為 false。

<Reboot>"true" / "false"</Reboot>
如果未指定此選項，預設值是 false。這表示伺服器將不會在安裝程式結束後自動重新啟動。另外，此選項只適用於最終安裝重新啟動，而其他元件可能不需要之前的重新啟動。

Note

安裝 Microsoft .NET Framework 可能會要求您必須重新啟動電腦，才能繼續執行 Microsoft Dynamics 365 Server 安裝程式。

<Email>
<IncomingExchangeServer name="ServerName"/>
此選用元素會指定電子郵件路由器要用來路由傳送接收電子郵件訊息的 Microsoft Exchange Server 電腦或 POP3。如果未指定，但稍後會在部署中使用電子郵件器，則必須將此電腦新增至 PrivUserGroup 安全性群組。

</Email>
指定電子郵件路由使用的電子郵件伺服器。

<configdb>
此為下列加密金鑰元素的上層：

警告

根據預設，加密金鑰不會以加密格式儲存在設定資料庫中。當您執行時安裝程式時，我們強烈建議您指定加密。

<encryptionkeys certificate="CrmEncryptionCertificate" generate="true"/"False" password="SCpassword" keysource="uniqueID">
<encryptionkeys> 元素指定如何和是否加密 Dynamics 365 Customer Engagement (on-premises) 系統中所儲存的金鑰。使用 generate="true"，讓系統產生的金鑰可以加密。 keysource 可以是任何值，但必須與其他的 keysource 值不同。 SCpassword 是用來建立對稱憑證的密碼。唯有當您使用設定檔時才可使用此設定。

警告

維護已指定 password 和 keysource 值的設定檔案具有安全性風險，因為您是以純文字儲存密碼和金鑰資訊。建議您將密碼儲存在安全位置，以供日後復原使用。然後，只要使用設定檔安裝了 Dynamics 365 Server，就立即刪除這些元素。

<encryptionkey physicalname="CrmSymmetricKey" virtualname="CrmKeyEncryptionKey"/>
每個 <encryptionkeys> 元素都會指定對稱金鑰存放區 (位於 SQL Server 資料庫) 與虛擬金鑰名稱 (硬式編碼於 Dynamics 365 Customer Engagement (on-premises)，用來加密設定資料庫中的資料) 之間的對應。唯有當您使用設定檔時才可使用此設定。

</encryptionkeys>
</configdb>
<LaunchReportingExtensionsSetup>"false" / "true"</LaunchReportingExtensionsSetup>
選用元素，指定是否要在 Dynamics 365 Server 安裝程式完成之後立即啟動 Dynamics 365 報表擴充功能安裝程式。根據預設，第一個元素的值為 false，而且 Dynamics 365 報表擴充功能安裝程式不會在 Dynamics 365 Server 安裝程式完成之後啟動。此外，Dynamics 365 Server 安裝程式也只會在符合下列情況時啟動：

Dynamics 365 Server 安裝程式會在部署中建立或升級組織
指定的報表伺服器電腦是正在執行安裝程式的本機電腦

另請參閱

使用命令提示字元安裝 Microsoft Dynamics 365
範例伺服器 XML 設定檔

 以預先建立群組安裝的範例伺服器 XML 設定檔

共用方式為

Microsoft Dynamics 365 Server XML 設定檔

設定檔偏好設定

另請參閱

意見反應

其他資源