シールされた Commerce セルフサービス コンポーネントの一括配置
警告
Commerce Scale Unit (CSU) がバージョン 10.0.29 以降に更新されると、POS (Modern POS または Store Commerce) のバージョンは 10.0.27 以降である必要がります (POS バージョン 9.27 にあります)。 これは、.NET Core. への移行によります。
この記事は、10.0.18 リリース以降、毎月リリースされ、Microsoft Dynamics Lifecycle Services (LCS) の共用資産ライブラリで使用可能な、シールド フレームワーク、コンポーネント インストーラーに適用されます。 これらの新しいインストーラーの最初のいくつかのリリースが (プレビュー) として指定されることに注意してください。 ただし、この指定の唯一の目的は、新しいインストーラーを区別し、Microsoft が新しい機能要件を使用するかどうかを決定するために行います。 これは、インストーラーが生産に対して有効ではないという意味ではありません。 これらの新しいインストーラーのリリースに基づいて、Microsoft は 2023 年 10 月またはその前後に古い (レガシ) インストーラーを廃止する予定です。
この記事では、新しいインストーラーを使用して、サイレント インストールおよびコマンド ライン引数によるサービスの更新を実行する方法について説明します。 これらの引数を使用すると、さまざまな方法で一括配置を行うことができます。
メモ
- セルフサービスのシールド インストーラーは Commerce headquarters では使用できず、LCS によってのみダウンロードできます。
- Commerce バージョン 10.0.32 リリースから、.NET 6 は、シールド セルフサービス コンポーネントの前提条件として必要です。
一括配置の区切り記号
次のテーブルに、コマンド ライン実行で使用できる区切り記号を示します。
| 区切り記号 | 説明 |
|---|---|
| --AadTokenIssuerPrefix | Microsoft Entra トークン発行者の接頭語。 |
| --AsyncClientAadClientId | Async Client が本社との通信中に使用する必要がある Microsoft Entra クライアント ID。 |
| --AsyncClientAppInsightsInstrumentationKey | Async Client AppInsights インストルメンテーション キー。 |
| --AsyncClientCertFullPath | 本社との通信のために Microsoft Entra で認証するために使用する必要がある、Async Client ID 証明書の場所の検索メトリックとして拇印を使用する完全に書式設定された URN パス。 たとえば、store://My/LocalMachine?FindByThumbprint=<MyThumbprint> が正しく書式設定された URN です。 値 <MyThumbprint> は、使用する必要のある証明書の拇印に置き換えられます。 このパラメータは、-AsyncClientCertThumbprint パラメータと一緒に使用しないでください。 |
| --AsyncClientCertThumbprint | 本社との通信で Microsoft Entra でするために使用する必要がある Async Client ID 証明書の拇印。 この拇印は、LocalMachine/My ストアの場所と名前を検索して、使用する正しい証明書を見つけるために使用します。 このパラメータは、-AsyncClientCertFullPath パラメータと一緒に使用しないでください。 |
| --ClientAppInsightsInstrumentationKey | クライアント AppInsights インストルメンテーション キー。 |
| --CloudPosAppInsightsInstrumentationKey | Cloud POS AppInsights インストルメンテーション キー。 |
| --Config | インストール時に使用する構成ファイル。 ファイル名の例は Contoso.CommerceScaleUnit.xml です。 コンフィギュレーション ファイルの作成方法の追加情報については、以下を参照してください。 |
| --CposAadClientId | デバイスの有効化中に Cloud POS が使用する必要がある Microsoft Entra クライアント ID。 このパラメータは、オンプレミスの配置に必要ありません。 |
| --Device | 本社のデバイス ページに表示されるデバイス ID。 |
| --EnvironmentId | 環境 ID。 |
| --HardwareStationAppInsightsInstrumentationKey | Hardware Station 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 でするために使用する必要がある Retail Server 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 | Transaction Service Microsoft Entra オーソリティ。 |
| --TransactionServiceAzureResource | Transaction Service Microsoft Entra リソース。 |
| --TrustSqlServerCertificate | SQL Server への接続が確立されている間にサーバー証明書を信頼する必要があるかどうかを示す切り替え。 セキュリティ リスクを回避するために、運用配置は、ここで true の値を指定しないでください。 既定値は false です。 |
| --UseCommonApplicationData | デバイス トークンの場所を変更するための切り替え。 トークンはユーザー コンテキストにあるのではなく、共有の場所に格納されるため、すべての Windows ユーザーが同じトークンにアクセスでき、有効なユーザーに関係なく Store Commerce を使用できます。 ユーザーは引き続き RetailChannelUsers グループに属している必要があります。 |
| --Verbosity | インストール中に要求されるログのレベル。 通常、この値は使用しないでください。 |
| --WindowsPhoneAppInsightsInstrumentationKey | Hardware Station 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が配布する基本コンポーネントのインストーラーと、機能拡張ベースのカスタマイズとは完全に分離されます。 カスタマイズは後でインストールされますが、更新に関しては解除されます (そのため、更新は Microsoft 基本コンポーネントのみ、カスタマイズのみ、またはその両方で許可されます)。
- GUI - : ユーザー インターフェイス (UI) は不要です。 代わりに、各コンポーネント インストーラーのコマンド ライン駆動型の実行可能ファイルがあります。 この変更は、一括配置で使用する新しいインストーラー フレームワークに焦点を合わせるために使用されるいくつかのキー変更または機能の 1 つです。
- 高度なログ : 強化されたインストーラー ログを使用すると、インストールの完了または失敗の検証、実行された手順、および生成された警告またはエラーを向上できます。
- クリーンアップ : 新しいフレームワークでは、コンポーネントインストーラーは、新しいコンポーネントをインストールする前に、コンポーネント フォルダの内容を完全にクリアしてインストール ディレクトリの動作を維持します。 このクリーンアップにより、問題を引き起こしてインストールの成功を妨げる可能性のあるファイルが残っていないことが保証されます。
3つのコンポーネントは新しいフレームワークに移行されていません: 仮想周辺機器シミュレーター、Async Server Connector Service (Dynamics AX 2012 R3 サポートに使用)、およびリアル タイム サービス交換 (Dynamics AX 2012 R3 サポートに使用)。
メモ
インストーラはローカルに保存され、保持されます。 ディスク領域を浪費しないように、保持されているインストーラーを管理または削除することが、時間の経過とともに重要になります。 極端な状況からの回復のために、基本コンポーネントの現在のインストーラーと最新バージョンの拡張機能インストーラーを保持することをお勧めします。
移行
古いセルフサービス フレームワーク コンポーネント インストーラーから新しいフレームワーク コンポーネント インストーラーに移行するには、古いコンポーネントをアンインストールする必要があります。
- Modern POS : 新しいインストーラー フレームワークにより、アプリケーションが新しいアプリケーション署名IDを受け取る原因でした。 したがって、新しいフレームワーク Modern POS コンポーネントがインストールされる前に、古いコンポーネントの完全なアンインストールが必要です。 完全なアンインストールが必要なので、デバイスの有効化が再度必要になります。 (このデバイスの最有効化は、アンインストールが再度発生しない限り、1 回限りの要件です。)
- ハードウェアの : IISのWebサイトとして、新しいインストーラー フレームワークでは、基本フォルダの構造を再作業する必要があります。 したがって、新しいフレームワーク ハードウェア ステーション コンポーネントがインストールされる前に、古いコンポーネントの完全なアンインストールが必要です。
- Commerce Scale Unit (CSU、セルフホスト) : 一連のIIS Webサイトとして、新しいインストーラー フレームワークでは、基本フォルダ構造を再作業する必要があります。 したがって、新しいフレームワーク CSU (自己ホスト) コンポーネントがインストールされる前に、古いコンポーネントの完全なアンインストールが必要です。
Modern POS
準備
古いセルフ サービス Modern POS コンポーネントを削除することが重要です。 詳細については、この記事で前述した移行手順を参照してください。 追加要件としての、Windows 認証 と SQL Server 認証 の両モードを使用する必要がある SQL インスタンス。 この構成は、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
これらの概念を組み合わせて、必要なインストール結果を達成できます。
Hardware station
準備
古いセルフ サービス ハードウェア ステーション コンポーネントを削除することが重要です。 詳細については、この記事で前述した移行手順を参照してください。 マーチャント アカウント情報ツールは使用されなくなりました。 代わりに、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"
これらの概念を組み合わせて、必要なインストール結果を達成できます。