IISWebAppDeploymentOnMachineGroup@0 - IIS Web アプリの v0 タスクの展開

このタスクを使用して、Web 配置を使用して Web サイトまたは Web アプリケーションをデプロイします。

構文

# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: # string. Required. Website Name. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
  # Advanced Deployment Options
    #SetParametersFile: # string. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
    #AdditionalArguments: # string. Additional Arguments. 
  # File Transforms & Variable Substitution Options
    #XmlTransformation: false # boolean. XML transformation. Default: false.
    #XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
    #JSONFiles: # string. JSON variable substitution.

入力

WebSiteName - Web サイト名
string. 必須です。

マシン グループ コンピューター上の既存の Web サイトの名前を指定します。

VirtualApplication - 仮想アプリケーション
string.

ターゲット マシン上の既存の Azure Virtual アプリケーションの名前を指定します。

Package - パッケージまたはフォルダー
string. 必須です。 既定値: $(System.DefaultWorkingDirectory)\**\*.zip。

MSBuild または圧縮アーカイブ ファイルによって生成されるパッケージまたはフォルダーへのファイル パスを指定します。 変数 ( ビルド | リリース) とワイルドカードがサポートされています。 たとえば、「 $(System.DefaultWorkingDirectory)\**\*.zip 」のように入力します。

SetParametersFile - SetParameters ファイル
string.

任意。 使用するファイルの場所を SetParameters.xml 指定します。

RemoveAdditionalFilesFlag - 宛先で追加のファイルを削除する
boolean. 既定値: false。

Web App zip パッケージに一致するファイルがない Web アプリ上のファイルを削除するオプションを選択します。

ExcludeFilesFromAppDataFlag - App_Data フォルダーからファイルを除外する
boolean. 既定値: false。

フォルダー内のファイルが App_Data Web アプリに展開されないようにするオプションを選択します。

TakeAppOfflineFlag - アプリをオフラインにする
boolean. 既定値: false。

同期操作を開始する前に Web アプリのルート ディレクトリにファイルを app_offline.htm 配置して、Web アプリをオフラインにするオプションを選択します。 同期が正常に完了すると、ファイルは削除されます。

AdditionalArguments - その他の引数
string.

Azure Web アプリのデプロイ時に適用される追加の Web デプロイ引数を指定します。 たとえば、-disableLink:AppPoolExtension または -disableLink:ContentExtension です。

Web 配置引数の一覧については、「 Web 配置操作の設定」を参照してください。

XmlTransformation - XML 変換
boolean. 既定値: false。

と で実行*.Release.config*.<EnvironmentName>.configされる構成変換を指定します*.config file。 構成変換は、変数の置換の前に実行されます。 XML 変換は Windows でのみサポートされています。

XmlVariableSubstitution - XML 変数の置換
boolean. 既定値: false。

ビルドまたはリリース パイプラインで定義されている変数を指定します。 これらの変数は、任意の構成ファイルと の appSettings、applicationSettings、connectionStrings セクションの または name エントリとparameters.xml照合されますkey。 変数置換は、構成変換の後に実行されます。

メモ： リリース パイプラインと環境で同じ変数が定義されている場合、環境変数はリリース パイプライン変数よりも優先されます。

JSONFiles - JSON 変数の置換
string.

変数値を置き換える JSON ファイルの新しい行区切りリストを指定します。 ファイル名は、ルート フォルダーに対する相対パスである必要があります。

入れ子または階層構造の JSON 変数を置き換えるには、JSONPath 式を使用して指定します。 たとえば、次のサンプルの の ConnectionString 値を置き換えるには、ビルドまたはリリース パイプライン (またはリリース パイプラインのステージ) で として Data.DefaultConnection.ConnectionString 変数を定義する必要があります。

{  
  "Data": {  
    "DefaultConnection": {  
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"  
    }  
  }  
}

変数置換は、構成変換の後に実行されます。

メモ： パイプライン変数は置換で除外されます。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

WebDeploy を使用して Web サイトまたは Web アプリをデプロイするには、このタスクを使用します。

必要条件

要件	説明
パイプラインの種類	クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.104.1 以降
タスクのカテゴリ	デプロイ