モジュールのWeb配置パッケージ

開始する前に、Sitecore Azure Toolkitをインストールし、コマンドレットをPowerShellセッションに読み込む必要があります。必要なコマンドレットは、次のファイルで定義されています。

SitecoreモジュールのZIPパッケージまたはTeam Development for Sitecore.updateパッケージを使用し、次のPowerShell呼び出しを使用してMSDeployと互換性のある同等の.scwdp.zipパッケージに変換できます。

ConvertTo-SCModuleWebDeployPackage [-Path] <string> [[-Destination] <string>]

これにより、次の内容の.scwdp.zipパッケージが作成されます。

.scwdp.zipパッケージは、次のパラメーターを受け入れます。

高度なシナリオ

次のセクション(変換の適用動的変換の埋め込み、パッケージへのファイルの埋め込み、パラメーターの調整、複数のコマンドの連続呼び出し、パッケージのテスト) など、より高度なシナリオを実行する場合など、より高度なシナリオを実行する場合。

変換を適用して、次のシナリオでモジュールを構成できます。

以下を参考にしてください。

Update-SCWebDeployPackage [-CargoPayloadPath] <string[]> [-Path <string>] [-WhatIf]:

動的変換を使用すると、モジュールは、モジュールのインストール時にターゲットのSitecoreインストールを変換できます。たとえば、HTTPハンドラーをWeb.configファイルに追加できます。

次の参照を使用してください。

Update-SCWebDeployPackage [-EmbedCargoPayloadPath] <string[]> [-Path <string>] [-WhatIf]

SCCPL変換は、事前構築済みのファイル セットと構成変更をWDPに追加するのに便利です。ただし、新しいデータベースの個々のファイル (dacpacファイルなど) をWDPに埋め込むこともできます。

次の参照を使用してください。

Update-SCWebDeployPackage [-SourcePath] <string> [-Path <string>]

デプロイメント・プロセスをカスタマイズする場合、またはモジュールを使用してdacpacまたはSQLファイルをデプロイする必要がある場合は、カスタム・parameters.xml・ファイルを作成してデプロイメント・パッケージに埋め込む必要があります。IIS Webアプリケーション パッケージの参照を使用してパラメーターを定義することもできます。

WDPにparameters.xmlファイルを適用すると、SATはパッケージ マニフェストを自動的に再生成して、参照するファイルをパラメータに含めます。これは、parameters.xmlファイルが一種のマニフェストになり、パッケージの内容を説明することを意味します。

次のコマンドは、パラメータを追加し、マニフェストを再生成します。

Update-SCWebDeployPackage [-ParametersXmlPath] <string> [-Path <string>]

また、単一のコマンドラインでコマンドをパイプすることもできます。

$WDP = ConvertTo-SCModuleWebDeployPackage $ZIP or $Update | `Update-SCWebDeployPackage -CargoPayloadPath @($SCCPL) | `Update-SCWebDeployPackage -SourcePath $DACPAC | `Update-SCWebDeployPackage -ParametersXmlPath $Parameters

.NETを使用する場合は、ConvertTo-SCModuleWebDeployPackageをdotnetに置き換え、公開してから、通常どおりWDPを操作します。

Microsoft Web Deployを使用すると、次のコマンド ラインを使用して、ローカル システム上でパッケージのインストールをテストできます。

msdeploy -verb:sync -source:package=%CD%\test.scwdp.zip -dest:archiveDir=%CD%\output -setParam:X=TESTVALUE

デプロイ時にDisableDacPacOptionsを使用して、テーブルまたはユーザーを作成します。モジュールWDPパッケージをオンプレミスインスタンスにデプロイする場合は、SqlDatabaseOptionsを無効にする必要があります。 SqlDatabaseOptionsを無効にしない場合、msDeployは包含データベースを非包含データベースに変換しようとし、モジュール パッケージの配置中にこれらのオプションを適用しようとすると、間違った結果が生成されます。

ConvertTo-SCModuleWebDeployPackageおよびUpdate-SCWebDeployPackageで使用できるプロパティDisableDacPacOptionsを使用すると、モジュール パッケージのSqlDatabaseOptionsを使用不可に構成できます。

デフォルト値は空です。これは、モジュールWDPパッケージのデータベース オプションがdbdacfxのすべての使用で同期されることを意味します。

値 "*" を指定すると、dbdacfxプロバイダーのすべての使用で、プロバイダー プロパティScriptDatabaseOptionsが "false" に設定されます。また、dbdacfxパスのリストを受け取る場合もあります。

次のコード サンプルは、その一例です。