メモ
Dynamics 365 Commerce の小売業務グループは、Yammer から Viva Engage に移行しました。 新しい Viva Engage コミュニティにアクセスできない場合は、このフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力して追加し、最新のディスカッションに参加してください。
警告
Commerce Scale Unit (CSU) がバージョン 10.0.29 以降に更新されると、POS (Modern POS または Store Commerce) のバージョンは 10.0.27 以降である必要がります (POS バージョン 9.27 にあります)。 この要件は、.NET Core への移行が原因です。
この記事は、10.0.18 リリース以降、Microsoft が毎月リリースする封印されたフレームワークとコンポーネントのインストーラーに適用されます。 Microsoft では、これらのインストーラーを Microsoft Dynamics Lifecycle Services の共有資産ライブラリで使用できるようにします。 これらの新しいインストーラーの最初のいくつかのリリースは 、(プレビュー) として指定されています。 ただし、この指定では新しいインストーラーのみが区別されますが、Microsoft では、新しいインストーラーを使用するための他の機能要件があるかどうかを判断します。 これは、インストーラーが生産に対して有効ではないという意味ではありません。 これらの新しいインストーラーのリリースに基づいて、Microsoft は 2023 年 10 月またはその前後に古い (レガシ) インストーラーを廃止する予定です。
この記事では、新しいインストーラーを使用して、コマンド ライン引数を使用してサイレント インストールとサービス更新を実行する方法について説明します。 これらの引数を使用すると、さまざまな方法で一括配置を行うことができます。
メモ
- コマース本社では、セキュリティで保護されたセルフサービスのインストーラーにはアクセスできません。 Microsoft Dynamics Lifecycle Services (LCS) 経由でのみダウンロードできます。
- Commerce バージョン 10.0.32 リリースから、.NET 6 は、シールド セルフサービス コンポーネントの前提条件として必要です。
一括配置の区切り記号
次の表に、コマンド ラインの実行で使用できる区切り記号を示します。
| 区切り記号 | 内容 |
|---|---|
| --AadTokenIssuerPrefix | Microsoft Entra トークン発行者の接頭語。 |
| --AsyncClientAadClientId | Async Client が本社との通信中に使用する必要がある Microsoft Entra クライアント ID。 |
| --AsyncClientAppInsightsInstrumentationKey | 非同期クライアント AppInsights インストルメンテーション キー。 |
| --AsyncClientCertFullPath | 本社との通信のために Microsoft Entra で認証するために使用する必要がある、Async Client ID 証明書の場所の検索メトリックとして拇印を使用する完全に書式設定された URN パス。 たとえば、store://My/LocalMachine?FindByThumbprint=<MyThumbprint> が正しく書式設定された URN です。
<MyThumbprint> の値は、使用する証明書の拇印に置き換えられます。 このパラメータは、-AsyncClientCertThumbprint パラメータと一緒に使用しないでください。 |
| --AsyncClientCertThumbprint | 本社との通信に Microsoft Entra で認証するために使用する非同期クライアント ID 証明書の拇印。 この拇印は、 LocalMachine/My ストア の場所と名前を検索して、使用する正しい証明書を見つけるために使用されます。 このパラメータは、-AsyncClientCertFullPath パラメータと一緒に使用しないでください。 |
| --ClientAppInsightsInstrumentationKey | クライアント AppInsights インストルメンテーション キー。 |
| --CloudPosAppInsightsInstrumentationKey | クラウド POS AppInsights インストルメンテーション キー。 |
| --Config | インストール時に使用する構成ファイル。 ファイル名の例は Contoso.CommerceScaleUnit.xml です。 |
| --CposAadClientId | デバイスの有効化中に Cloud POS が使用する必要がある Microsoft Entra クライアント ID。 このパラメータは、オンプレミスの配置に必要ありません。 |
| --Device | 本社のデバイス ページに表示されるデバイス ID。 |
| --EnvironmentId | 環境 ID。 |
| --HardwareStationAppInsightsInstrumentationKey | ハードウェア ステーション AppInsights インストルメンテーション キー。 |
| --InPlaceUpgradeFromModernPOS | Modern POS から Store Commerce にアップグレードするために使用します。 他のパラメーターを使用しない限り、既定の前提は Modern POS デバイス トークンをキャプチャし、Modern POS をアンインストールすることです。 |
| インストール | このインストーラーが提供するコンポーネントをインストールするかどうかを指定するパラメーター。 インストールを実行する際にはこのパラメータが必要で、先頭にダッシュ文字はありません。 |
| --InstallOffline | Modern POS の場合、このパラメータは、オフライン データベースもインストールして構成する必要があることを指定します。 -SQLServerName パラメータも使用します。 それ以外の場合、インストーラーは前提条件を満たす既定のインスタンスを見つけようとします。 Microsoft Entra 認証を使用する場合、オンライン接続が常に必要であるため、POS オフラインは機能しません。 |
| --Port | Retail Server 仮想ディレクトリに関連付けられて使用されるポート。 ポートを設定しない場合は、既定のポート 443 が使用されます。 |
| --Register | 本社の登録ページに表示される登録 ID。 |
| --RetailServerAadClientId | Retail Server が本社との通信中に使用する必要がある Microsoft Entra クライアント ID。 |
| --RetailServerAadResourceId | デバイスの有効化中に使用するRetail Server Microsoft Entra アプリ リソース ID。 このパラメータは、オンプレミスの配置に必要ありません。 |
| --RetailServerCertFullPath | 本社との通信のために Microsoft Entra で認証するために使用する必要がある、Retail Server ID 証明書の検索メトリックとして拇印を使用する完全に書式設定された URN パス。 たとえば、store://My/LocalMachine?FindByThumbprint=<MyThumbprint>は正しく書式設定された URN で、値<MyThumbprint>は、使用したい証明書の拇印に置き換えられます。 このパラメータは、-RetailServerCertThumbprint パラメータと一緒に使用しないでください。 |
| --RetailServerCertThumbprint | 本社との通信に Microsoft Entra で認証するために使用するリテール サーバー ID 証明書の拇印。 この拇印は、 LocalMachine/My ストアの場所と名前を検索して、使用する正しい証明書を見つけるために使用されます。 このパラメータは、-RetailServerCertFullPath パラメータと一緒に使用しないでください。 |
| --RetailServerURL | インストーラーが使用する Retail Server URL。 (この URL は Commerce Scale Unit [CSU] URL とも呼ばれます)。Modern POS の場合、この値はデバイスのアクティブ化中に使用されます。 |
| --SkipAadCredentialsCheck | Microsoft Entra 資格情報の前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipCertCheck | 証明書の前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipEnhancedModernPOSUpgradeValidation | Modern POS からデバイス トークン キャプチャを実行する前に実行される標準検証をスキップするスイッチ。 このフラグはテスト環境でのみ使用し、運用環境では使用しないでください。 |
| --SkipIisCheck | インターネット インフォメーション サービス (IIS) の前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipNetFrameworkCheck | .NET Framework の前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipScaleUnitHealthcheck | インストールされているコンポーネントの正常性チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipSChannelCheck | セキュリティ チャネルの前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipSqlFullTextCheck | フル テキスト検索を必要とする SQL Server の前提条件の検証をスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipSqlServerCheck | SQL Server の前提条件チェックをスキップする必要があるかどうかを示す切り替え。 既定値は false です。 |
| --SkipUninstallModernPOSAfterUpgrade | Store Commerce へのアップグレードおよび Modern POS からのデバイス トークン のキャプチャを実行した後、Modern POS のアンインストールをスキップするための切り替え。 |
| --SqlServerName | SQL Server 名。 名前を指定しない場合、インストーラーは既定のインスタンスを検索しようとします。 |
| --SslcertFullPath | スケール ユニットへの HTTP トラフィックを暗号化するために使用する必要がある証明書の場所の検索メトリックとして拇印を使用する、完全に書式設定された URN パス。 たとえば、store:\/\/My\/LocalMachine\?FindByThumbprint\=\<MyThumbprint\> は正しく書式設定された URN であり、値 <MyThumbprint> は使用する証明書の拇印に置き換えられます。 このパラメータは、-SslCertThumbprint パラメータと一緒に使用しないでください。 |
| --SslCertThumbprint | スケール ユニットに対する HTTP トラフィックを暗号化するために使用する必要がある証明書の拇印。 この拇印は、 LocalMachine/My ストア の場所と名前を検索して、使用する正しい証明書を見つけるために使用されます。 このパラメータは、-SslCertFullPath パラメータと一緒に使用しないでください。 |
| --StoreSystemAosUrl | 本社 (AOS) URL。 |
| --StoreSystemChannelDatabaseId | チャネル データベース ID (名前)。 |
| --TenantId | Microsoft Entra テナント ID。 |
| --TransactionServiceAzureAuthority | Microsoft Entra の取引サービス機関。 |
| --TransactionServiceAzureResource | Microsoft Entra の取引サービス リソース。 |
| --TrustSqlServerCertificate | SQL Server への接続が確立されている間にサーバー証明書を信頼する必要があるかどうかを示す切り替え。 セキュリティ リスクを回避するために、運用配置は、ここで true の値を指定しないでください。 既定値は false です。 |
| --UseCommonApplicationData | デバイス トークンの場所を変更するための切り替え。 トークンはユーザー コンテキストにあるのではなく、共有の場所に格納されるため、すべての Windows ユーザーが同じトークンにアクセスでき、有効なユーザーに関係なく Store Commerce を使用できます。 ユーザーは引き続き RetailChannelUsers グループに属している必要があります。 |
| --Verbosity | インストール中に要求されるログのレベル。 通常、この値は使用しないでください。 |
| --WindowsPhoneAppInsightsInstrumentationKey | ハードウェア ステーション AppInsights インストルメンテーション キー。 |
一般的な概要
セルフサービス インストーラー用の新しいフレームワークでは、さまざまな機能と機能強化が提供されます。 現在、新しいフレームワークでは、Modern POS、ハードウェア ステーション、および CSU (セルフホステッド) のインストーラーのみが生成されます。 シールされたインストーラーの基本的なコマンド ラインの使用方法を理解する必要があります。これは、次の例の使用方法のようになります。
<Component Installer Name>.exe install --<Parameter Name> "<Parameter Information>"
インストーラーは、システムの変更を必要とする前提条件のインストールを自動的に実行しません。 そのため、不足している、または正しくない前提条件に関するインストーラーの指示に従う必要があります。 たとえば、レジストリで次の TLS 1.0 キーと TLS 1.1 キーを無効にする必要があります。
- Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.0\Client\Enabled = 0
- Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.0\Server\Enabled = 0
- Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Client\Enabled = 0
- Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Server\Enabled = 0
- Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft.NETFramework\v2.0.50727\SchUseStrongCrypto = 1
- Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v2.0.50727\SchUseStrongCrypto = 1
構成ファイルを使用する場合は、必要に応じて、パラメーターの名前と値でタイトル付けされたキーを使用する XML ファイルにする必要があります。 必要なコンフィギュレーション ファイルを作成する例として、Store Commerce に焦点を当てた次のコンフィギュレーション ファイルを使用します。
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<appSettings>
<add value="HOUSTON-3" key="register" />
<add value="HOUSTON-3" key="device" />
<add value="https://MyCSU_URL_LINK.dynamics.com" key="retailserverurl" />
<add key="installoffline" />
<add value="MyMachineName\SQLEXPRESS" key="sqlservername" />
<add key="inplaceupgradefrommodernpos" />
<add key="usecommonapplicationdata" />
</appSettings>
</configuration>
インストーラーには、パラメーター インストール (またはインストールを削除するにはアンインストール) とそのインストールに固有のパラメーターが必要です。 パラメーター名には、登録、CSU URL、または証明書情報などの必要なパラメーターを含める必要があります。 パラメーター情報には、パラメーターに関する追加情報が含まれる必要があります。
シールドされたフレームワークは、次の変更をサポートしています。
- シールド – 新しいインストーラー フレームワークは、マイクロソフト基本コンポーネント インストーラーを、拡張性ベースのカスタマイズから完全に分離します。 カスタマイズは後でインストールされますが、更新プログラムに関してはテザリングされません。 この分離により、更新プログラムは、Microsoft 基本コンポーネントに対してのみ、カスタマイズの場合のみ、またはその両方に対してのみ許可されます。
- GUI-less – ユーザー インターフェイス (UI) は使用されなくなりました。 代わりに、各コンポーネント インストーラーに対してコマンド ライン駆動の実行可能ファイルがあります。 この変更は、一括展開で使用する新しいインストーラー フレームワークに焦点を当てたいくつかの重要な変更または機能の 1 つです。
- より詳細なログ記録 – 拡張インストーラー ログを使用すると、インストールの完了または失敗、実行された手順、生成された警告やエラーの検証が向上します。
- クリーンアップ – 新しいフレームワークでは、コンポーネント インストーラーは、新しいコンポーネントをインストールする前にコンポーネント フォルダーの完全な内容をクリアすることで、インストール ディレクトリの清潔さを維持するためにより困難に動作します。 このクリーンアップにより、残ったファイルが問題を引き起こさなくなり、インストールが正常に行われなくなります。
仮想周辺機器シミュレーター、非同期サーバー コネクタ サービス (Dynamics AX 2012 R3 サポートに使用)、リアルタイム サービス交換 (Dynamics AX 2012 R3 サポートに使用) の 3 つのコンポーネントは新しいフレームワークに移行されません。
メモ
インストーラはローカルに保存され、保持されます。 時間の経過と同時に、保持されているインストーラーを管理または削除して、ディスク領域を無駄にしないようにします。 極端な状況からの回復に役立つように、基本コンポーネントの現在のインストーラーと最新バージョンの拡張機能インストーラーを保持します。
移行
古いセルフサービス フレームワーク コンポーネント インストーラーから新しいフレームワーク コンポーネント インストーラーに移行するには、古いコンポーネントをアンインストールします。
- モダン POS – 新しいインストーラー フレームワークによって、アプリケーションに新しいアプリケーション署名 ID が提供されます。 そのため、新しいフレームワーク Modern POS コンポーネントをインストールする前に、古いコンポーネントをアンインストールする必要があります。 古いコンポーネントをアンインストールする必要があるため、デバイスをもう一度アクティブ化する必要があります。 このデバイスの再アクティブ化は、新しいコンポーネントをアンインストールしない限り、1 回限りの要件です。
- ハードウェア ステーション – IIS Web サイトとして、新しいインストーラー フレームワークでは、ベース フォルダー構造を作り直す必要があります。 そのため、新しいフレームワーク ハードウェア ステーション コンポーネントをインストールする前に、古いコンポーネントをアンインストールする必要があります。
- Commerce Scale Unit (CSU、セルフホステッド) – 一連の IIS Web サイトとして、新しいインストーラー フレームワークでは、基本フォルダー構造を作り直す必要があります。 そのため、新しいフレームワーク CSU (セルフホステッド) コンポーネントをインストールする前に、古いコンポーネントをアンインストールする必要があります。
モダン POS
準備
古いセルフ サービス Modern POS コンポーネントを削除することが重要です。 詳細については、この記事で前述した移行手順を参照してください。 追加の要件として、使用する SQL インスタンスには 、Windows 認証 モードと SQL Server 認証 モードの両方が必要です。 この構成は、SQL Server Management Studio の プロパティ ウィンドウの セキュリティ サブヘディングで管理および変更できます。 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.0\Client\Enabled = 0 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.0\Server\Enabled = 0 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Client\Enabled = 0 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Server\Enabled = 0 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft.NETFramework\v2.0.50727\SchUseStrongCrypto = 1 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v2.0.50727\SchUseStrongCrypto = 1
メモ
開発者トポロジやデモ環境などの単一コンピューター システムで、または Commerce Scale Unit と Modern POS が同じコンピューターにインストールされている場合、Store Commerce がデバイスのアクティブ化を完了できない可能性があります。 この問題は、Store Commerce が同じコンピューター (つまり、それ自体への呼び出し) に対してネットワーク呼び出しを実行できないために発生します。 この問題は運用環境の設定では発生しませんが、AppContainer ループバック例外を有効にして、同じコンピューターに通信を行えるようにすることで、問題を軽減できます。 この Lookback を可能にするのに役立つさまざまなアプリケーションが公開されています。 ループバックの詳細については、ループバックの有効化およびネットワーク分離のトラブルシューティングの方法を参照してください。 ループバックはセキュリティ 上のリスクになる可能性があるため、必要でない限りループバックを使用しないでください。
サイレント配置の例
このセクションでは、Modern POS のインストールに使用できるコマンドの例を示します。
Modern POS をサイレント インストール
次のコマンドは、Modern POS をサイレント モードでインストールまたは更新します。 現在インストールされているコンポーネントのサイレント サービスに使用される標準的なコマンド構造があります。 この構造では、<InstallerName>.exe の基本値を使用します。
次の基本的なコマンドは、インストールが要求された場合に使用できるオプションを示しています。 このコマンドは、最初にインストーラーをテストまたは使用するときに使用します。
CommerceModernPOS.exe help install
メモ
Modern POS ではコンフィギュレーション ファイルは必要ありません。 インストーラーには、デバイスの有効化中に使用されるさまざまな値のパラメーター (この記事の前半で示した) があります。
次のコマンドは、Modern POS アプリケーションのインストール後にデバイスのアクティブ化時に使用する必要があるすべてのパラメーターを指定します。 この例では、Dynamics 365 Commerce デモ データで一般的に使用される値である、Houston-3 レジスター を使用します。
CommerceModernPOS.exe install --Register "Houston-3" --Device "Houston-3" --RetailServerURL "https://MyDynamics365CommerceURL.dynamics.com/Commerce"
次のコマンドは、オフライン データベースのインストールと構成に使用するパラメーターを指定します。 SQL Server は、使用する必要のある構成ファイルと一緒に指定されます。 信頼できる SQL 証明書が使われていない限り、--TrustSqlServerCertificate パラメータが必要です。 運用環境にインストールする場合は、チェックをスキップしないでください。
CommerceModernPOS.exe install -InstallOffline -SQLServerName "SQLExpress" -Config "ModernPOS.Houston-3.xml"
次のコマンドは、Modern POS から Store Commerce へのアップグレードに使用する必要があるパラメーターを指定します (オフライン データベースが使用されています)。 これらのパラメーターにより、Modern POS で使用されるデバイス トークンがキャプチャされ (手動でデバイスをアクティブ化するプロセスが不要になります)、Modern POS がアンインストールされます。 SQL Server は、使用する必要のある構成ファイルと一緒に指定されます。
CommerceModernPOS.exe install -InstallOffline -SQLServerName "SQLExpress" --InPlaceUpgradeFromModernPOS
これらの概念を組み合わせて、必要なインストール結果を達成できます。
ハードウェア ステーション
準備
古いセルフ サービス ハードウェア ステーション コンポーネントを削除することが重要です。 詳細については、この記事で前述した移行手順を参照してください。 マーチャントアカウント情報ツールは使用できなくなりました。 代わりに、POS ターミナルがハードウェア ステーションとペアリングすると、マーチャント アカウント情報がインストールされます。 このインストーラーを初めてテストするときは、次のコマンドを実行します。
CommerceHardwareStation.exe help install
サイレント配置の例
このセクションでは、ハードウェア ステーションのインストールに使用するコマンドの例を示します。
ハードウェア ステーションのサイレント インストール
次のコマンドにより、ハードウェア ステーションがサイレントでインストール (または更新) されます。 これには、現在インストールされているコンポーネントにサービスを提供するために使用する標準のコマンド構造があります。 この構造では、<InstallerName>.exe の基本値を使用します。
次の基本的なコマンドは、実行可能ファイル インストーラーを実行します。
HardwareStation.exe install --Port 443 --CSUURL "https://MyDynamics365CommerceURL.dynamics.com/" --StoreSystemChannelDatabaseID "Houston" --CertThumbprint "MySSLCertificateThumbprintOftenHasNumbers"
メモ
ハードウェア ステーションでは構成ファイルは必要ありません。 インストーラーには、必要なさまざまな値のパラメーター (この記事の前半で示した) があります。
次のコマンドでは、標準インストール中に前提条件チェックをスキップするために必要なすべてのパラメータを指定します。
メモ
事前に徹底的なテストを行わない限り、または開発状況を除き、チェックをスキップしないでください。 運用環境にインストールする場合は、チェックをスキップしないでください。
HardwareStation.exe install --SkipFirewallUpdate --SkipOPOSCheck --SkipVersionCheck --SkipURLCheck --Config "HardwareStation.Houston.xml"
慣例のように、これらの概念を組み合わせて、必要なインストール結果を実現します。
Commerce Scale Unit (自己ホスト)
このインストーラーを初めてテストするときは、次のコマンドを実行します。
CommerceStoreScaleUnitSetup.exe help install
準備
古いセルフサービス CSU (セルフホステッド) コンポーネントを削除します。 詳細については、この記事で前述した移行手順を参照してください。
サイレント配置の例
このセクションでは、CSU (セルフホステッド) をインストールするコマンドの例を示します。
CSU (自己ホスト) をサイレント インストール
次のコマンドにより、CSU (自己ホスト) がサイレントでインストール (または更新) されます。 現在インストールされているコンポーネントのサイレント サービスに使用される標準のコマンド構造があります。 この構造では、<InstallerName>.exe の基本値を使用します。
他のセルフサービス インストーラーと比較すると、Commerce Scale Unit (CSU) の方が複雑で、大量の追加情報が必要になります。 次のコマンドは、コンフィギュレーション ファイルが存在しない場合に実行可能ファイル インストーラーを実行するために最低限必要なコマンド (パラメーターを含む) です。 信頼できる SQL 証明書を使用しない限り、 --TrustSqlServerCertificate パラメーターを含めます。
CommerceScaleUnit.exe install --port 446 --SSLCertThumbprint "MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-AsyncClient" --RetailServerMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-RetailServer" --CPOSMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-CloudPOS" --RetailServerMicrosoft Entra IDResourceID "https://retailstorescaleunit.retailserver.com" --Config "Contoso.StoreSystemSetup.xml"
メモ
CSU (自己ホスト) では構成ファイルがまだ必要とされます。
次のコマンドは、いくつかの代替パラメーターを使用して実行可能ファイル インストーラーを実行するより完全なコマンドです。 信頼できる SQL 証明書を使用しない限り、 --TrustSqlServerCertificate パラメーターを含めます。
CommerceScaleUnit.exe install --Port 446 --SSLCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --AsyncClientCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-AsyncClient" --RetailServerMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-RetailServer" --CPOSMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-CloudPOS" --RetailServerMicrosoft Entra IDResourceID "https://retailstorescaleunit.retailserver.com" --Verbosity 0 --Config "Contoso.StoreSystemSetup.xml"
次のコマンドは、標準インストール中に前提条件チェックをスキップするために必要なパラメーターを指定します。
メモ
- 事前に徹底的なテストを行わない限り、または開発状況を除き、チェックをスキップしないでください。 運用環境にインストールする場合は、チェックをスキップしないでください。
- 信頼できる SQL 証明書を使用しない限り、
--TrustSqlServerCertificateパラメーターを含めます。
CommerceScaleUnit.exe install --skipscaleunithealthcheck --skipcertcheck --skipaadcredentialscheck --skipschannelcheck --skipiischeck --skipnetcorebundlecheck --skipsqlservercheck --skipnetframeworkcheck --skipversioncheck --skipurlcheck --Config "Contoso.StoreSystemSetup.xml" --SSLCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --AsyncClientCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-AsyncClient" --RetailServerMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-RetailServer" --CPOSMicrosoft Entra IDClientID "MyMicrosoft Entra ID-Client-IDFor-CloudPOS" --RetailServerMicrosoft Entra IDResourceID "https://retailstorescaleunit.retailserver.com"
これらの概念を組み合わせて、必要なインストール結果を達成できます。