Microsoft Dynamics 365 Serverの XML 構成ファイル

[アーティクル]
03/29/2023

この記事は、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>
構成ファイルは、ルート要素として <CRMSetup> を使用する有効な XML ファイルである必要があります。

<Server></Server>
Dynamics 365 Server のインストールを指定します。後に続くエントリはすべて <Server> 要素の中に含める必要があります。

<InstallType>Uninstall/Repair/Configure</InstallType>
セットアップによって実行されるインストールの種類を指定します。次のオプションを選択できます。

Uninstall: Dynamics 365 Server をアンインストールします。
Repair: セットアップを修復モードで開始します。
Configure: セットアップを構成モードで開始します。

<Patch update="true"/"false">\\ServerName\ShareName\Patch_Location</Patch>
更新 Microsoft Dynamics 365 Server セットアップテクノロジの動作を決定します。この機能を利用して、セットアップで 1 回限りの検索を実行し、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 です。

<組織>組織のわかりやすい名前または詳しい名前</組織>
組織の詳しい名前を指定します。名前は最大 250 文字まで指定でき、拡張文字がサポートされています。

<OrganizationUniqueName>一意の名前</OrganizationUniqueName>
UniqueName

ユーザーが展開にアクセスする際に使用する URLに組織の名前を指定します。 30 文字の制限があります。拡張文字またはスペースは使用できません。この要素を指定しなかった場合や値を空のままにした場合は、セットアップによって <Organization> 要素の値に基づいた短い名前が生成されます。

重要

一意の組織名を使用して、ユーザーがアプリケーションにサインインするための URL が作成されます。したがって、URL 全体の長さを短くするため、一意の組織名の長さを制限することをお勧めします。

<muoptin optin="true”/“false" />
Microsoft Update を使用して Dynamics 365 Server および他のインストール済みアプリケーションの更新プログラムをダウンロードおよびインストールするかどうかを指定します。インストールの完了後は、この機能はコンピューターを常に最新の状態に保つのに役立ちます。

True。このオプションを指定すると、セットアップは更新サービスとして Microsoft 更新プログラムを選択し、コンピューター上の Windows 自動更新設定を使用します。 Windows 自動更新設定は、コントロールパネルの Windows Update で表示されます。 Microsoft 更新プログラムは、お使いのコンピューターが最新のテクノロジを使用するように保ち、脆弱性やセキュリティの問題のリスクを低減させます。
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>
この展開のプロダクトキーを指定します。構成ファイルに含めることのできるプロダクトキーは 1 つのみです。例:

<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>
アプリケーションで使用される Web サイトを指定します。新しい Web サイトを作成するには、Create="true" を使用し、要素タグ間の値を空のままにします。 port="TCPportnumber" を使用します。ここで、 TCPportnumber は有効かつ使用可能なポート番号で、アプリケーションに接続するためのポートを指定します。空のままにした場合は、ポート番号 5555 が使用されます。

既存の Web サイトを使用するには、Create="false" を使用し、次のいずれかの形式で、要素タグ内に Web サイトのパスを入力する必要があります。 Create="false" 属性を使用する場合、ポート属性は無視されます。

たとえば、次のようなものです。

https://server:port/ または https:// server.contoso.com
/LM/W3SVC/ n、ここで、n は Web サイトの ID です。1 はデフォルトの Web サイトです。

<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 の 3 文字通貨コード、表示名、および基本通貨に使用する記号を指定します。たとえば、米国ドルを基本通貨として使用する場合は、isocurrencycode="USD" を使用します。 isocurrencycode 属性には有効な ISO 通貨表現を使用する必要があります。

currencyname and currencysymbol

また、ISO 基本通貨に対する通貨名および通貨記号の表示名を指定する必要もあります。たとえば、ISO 通貨コードが USD の場合は、通貨名を "US Dollar" にし、通貨記号を "$" にします。ただし、これらの属性については必要な任意の文字列を使用できます。

重要

セットアップの完了後に基本 ISO 通貨コードを変更することはできません。ただし、基本通貨名、基本通貨記号、基本通貨の有効桁数は変更できます。

通貨コードは Microsoft .NET フレームワークから提供されており、変更される場合があります。

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>
Dynamics 365 Customer Engagement (on-premises) 解凍サービスと ASP.NET AppPool アプリケーションプール ID の実行に使用するサービスアカウントを指定します。

許可された値は、<prefixServiceAccount> 要素または NetworkService で提供される DomainUser で、ネットワークサービスのシステムアカウントを使用します。ただし、Network Service システムアカウントの使用は、組織の作成、インポート、アップグレード、更新などの一部のデータベース操作が制限される場合があるのでお勧めできません。既定では、セットアップは DomainUser オプションを使用します。 DomainUser または種類なしを指定する場合は、<ServiceAccountLogin> および <ServiceAccountPassword> が必要です。 /Q または /QR パラメーターを使用してセットアップを実行するときに、この要素が指定されていない場合は、ネットワークサービスのアカウントが使用されます。

警告

これらのサービスの実行専用で他の目的に使用されない、特権の低いドメインアカウントを選択することを強くお勧めします。また、Dynamics 365 Customer Engagement (on-premises) サービスの実行に使用されるユーザーアカウントを Dynamics 365 Customer Engagement (on-premises) ユーザーにすることはできません。このドメインアカウントは、ドメインユーザーグループのメンバーであることが必要です。さらに、フルサーバーのインストールまたはバックエンドサーバーのインストールなどで非同期サービスロールおよびサンドボックス処理サービスロールがインストールされている場合、このドメインアカウントはパフォーマンスログユーザーセキュリティグループのメンバーである必要があります。

<SandboxServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
</SandboxServiceAccount>
サンドボックス処理サービスで使用するサービスアカウントを指定します。

受け付けられる値は、<prefixServiceAccount> 要素で提供される指定されたドメインユーザーを使用する DomainUser またはネットワークサービスのシステムアカウントを使用する NetworkService です。既定では、セットアップは DomainUser オプションを使用します。 DomainUser または種類なしを指定する場合は、<ServiceAccountLogin> および <ServiceAccountPassword> が必要です。 /Q または /QR パラメーターを使用してセットアップを実行するときに、この要素が指定されていない場合は、ネットワークサービスのアカウントが使用されます。

警告

この要素を指定しないと、セットアップは <CrmServiceAccount> 要素で指定されているアカウントを使用して、このサービスを実行します。したがって、サービスアカウントごとに権限の少ない異なるユーザーアカウントを指定することをお勧めします。

<DeploymentServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
<DeploymentServiceAccount>
展開 Web サービスで使用するサービスアカウントを指定します。

受け付けられる値は、<prefixServiceAccount> 要素で提供される指定されたドメインユーザーを使用する DomainUser またはネットワークサービスのシステムアカウントを使用する NetworkService です。ただし、Network Service システムアカウントの使用は、組織の作成、インポート、アップグレード、更新などの一部のデータベース操作が制限される場合があるのでお勧めできません。既定では、セットアップは DomainUser オプションを使用します。 DomainUser または種類なしを指定する場合は、<ServiceAccountLogin> および <ServiceAccountPassword> が必要です。 /Q または /QR パラメーターを使用してセットアップを実行するときに、この要素が指定されていない場合は、ネットワークサービスのアカウントが使用されます。

注意

指定した <ServiceAccountLogin> 値および <ServiceAccountPassword> 値が入っている構成ファイルを管理する場合は、パスワードがプレーンテキスト形式で格納されるため、セキュリティ上のリスクがあります。このような構成ファイルを使用して Dynamics 365 Server をインストールした後は、速やかにこれらの要素を削除してください。この要素を指定しないと、セットアップは <CrmServiceAccount> 要素で指定されているアカウントを使用して、このサービスを実行します。したがって、サービスアカウントごとに権限の少ない異なるユーザーアカウントを指定することをお勧めします。他のサービスアカウントで必要なアクセス許可のほか、展開 Web サービスアカウントは SQL Server のシステム管理者権限を必要とします。また、組織の作成およびインポートを可能にするために、SWL Server を実行しているローカル管理者グループのメンバーである必要があります。

重要

または展開 Web サービスか Windows PowerShell を通じて組織の操作を実行するには、展開サービスアカウントが SQL Server を実行しているコンピューターのシステム管理者権限を持ち、がインストールされているローカル管理者グループのメンバーである必要があります。また、組織の操作を実行するユーザーは展開管理者である必要があります。

展開管理者の役割を実行するには、展開管理者のロールが必要です。

<AsyncServiceAccount type="DomainUser"/"NetworkService">
<ServiceAccountLogin>Domain\User</ServiceAccountLogin>
<ServiceAccountPassword>password</ServiceAccountPassword>
<AsyncServiceAccount>
非同期処理サービスで使用するサービスアカウントを指定します。

受け付けられる値は、<prefixServiceAccount> 要素で提供される指定されたドメインユーザーを使用する DomainUser またはネットワークサービスのシステムアカウントを使用する NetworkService です。ただし、Network Service システムアカウントの使用は、組織の作成、インポート、アップグレード、更新などの一部のデータベース操作が制限される場合があるのでお勧めできません。既定では、セットアップは 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 という名前のセキュリティグループを追加した場合、mycrmprivgroupusers のメンバーは privusergroup のメンバーとして解決されません。これには、CRMAppPool または SQL Server Reporting Services のサービス ID が含まれます。

この設定は、構成ファイルを使用するときにのみ使用できます。

<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 Reporting Extensions セットアップを開始するかどうかを指定するオプション要素です。この要素の値は既定で false であるため、Dynamics 365 Server セットアップの完了後、Dynamics 365 Reporting Extensions セットアップは開始されません。また、Dynamics 365 Reporting Extensions セットアップは以下の条件が true の場合にのみ開始されます。

Dynamics 365 Server セットアップにより、展開内の最初の組織が作成またはアップグレードされる
指定されたレポートサーバーコンピューターは、セットアップを実行しているローカルコンピューターです

Microsoft Dynamics 365 Serverの XML 構成ファイル

構成ファイルの参照

関連情報

その他のリソース