IISWebAppDeployment@1 - IIS Web アプリの展開 (非推奨) v1 タスク

このタスクを使用して、MSDeploy を使用して IIS Web アプリを展開し、Web サイトとアプリ プールを作成または更新します。

重要

このタスクは非推奨であり、2024 年 1 月 31 日に廃止される予定です。 WinRM を使用した IIS Web アプリの展開 - Viual Studio Marketplace を使用します。

構文

# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

入力

EnvironmentName - マシン
string. 必須です。

コンピューターの IP アドレスまたは FQDN のコンマ区切りの一覧とポートを指定します。 既定のポートは、選択したプロトコル (例: dbserver.fabrikam.com または dbserver_int.fabrikam.com:5986,192.168.12.34:5986) に基づいています。 他のタスクの出力変数 (例: $(variableName)) を指定することもできます。

AdminUserName - 管理者ログイン
string.

ターゲット マシンの管理者ログインを指定します。

AdminPassword - パスワード
string.

ターゲット マシンの管理者パスワードを指定します。 ビルド/リリース定義で定義されている変数 (など $(passwordVariable)) を受け取ることができます。 変数の型を として secret マークして、セキュリティで保護することができます。

WinRMProtocol - プロトコル
string. 使用できる値: Http、Https。

コンピューターとの WinRM 接続に使用されるプロトコルを指定します。 既定では、 HTTPSです。

TestCertificate - テスト証明書
boolean. 省略可能。 の場合は WinRMProtocol = Httpsを使用します。 既定値: true。

信頼された証明機関によるマシンの証明書の信頼性の検証をスキップするオプションを選択します。 パラメーターは、WinRM HTTPS プロトコルに必要です。

WebDeployPackage - Web 配置パッケージ
string. 必須です。

ターゲット マシンまたは UNC パス上の Web 配置 (MSDeploy) zip ファイルの場所を指定します (例: \\BudgetIT\WebDeploy\WebDeployPackage.zip)。 UNC パスには、マシンの管理者アカウントからアクセスできる必要があります。 、、、 などの$env:windir$env:systemroot$env:windir\FabrikamFibre\Web環境変数もサポートされています。

WebDeployParamFile - Web 配置パラメーター ファイル
string.

ターゲット マシンまたは UNC パス上のパラメーター ファイルの場所を指定します。 パラメーター ファイルは、IIS Web アプリケーション名やデータベース 接続文字列などの Web アプリケーション構成設定をオーバーライドするために使用されます。

OverRideParams - パラメーターのオーバーライド
string.

ここで指定したパラメーターは、MSDeploy zip ファイルとパラメーター ファイルのパラメーターをオーバーライドします。 複数のパラメーターをオーバーライドするには、行区切り記号を使用します。
たとえば、"IIS Web Application Name"="Fabrikam" または "ConnectionString"="Server=localhost;Database=Fabrikam;" です。

CreateWebSite - Web サイトを作成または更新する
boolean. 既定値: false。

Web サイトを作成するか、既存の Web サイトを更新するオプションを指定します。

WebSiteName - Web サイト名
string. CreateWebSite = true の場合に必要です。

IIS Web サイトが存在しない場合に作成される IIS Web サイトの名前を指定します。IIS サーバーに既に存在する場合は更新されます。 Web サイトの名前は、Web デプロイ zip パッケージ ファイルで指定した名前と同じである必要があります。 パラメーター ファイルとオーバーライド パラメーターの設定も指定されている場合、Web サイトの名前はオーバーライド パラメーター設定の名前と同じである必要があります。

WebSitePhysicalPath - 物理パス
string. CreateWebSite = true の場合に必要です。 既定値: %SystemDrive%\inetpub\wwwroot。

Web サイトのコンテンツが格納される物理パスを指定します。 コンテンツは、ローカル コンピューター、リモート ディレクトリ、共有 (または \\ContentShare\FabrikamなどC:\Fabrikam) に配置できます。

WebSitePhysicalPathAuth - 物理パス認証
string. CreateWebSite = true の場合に必要です。 使用できる値: WebSiteUserPassThrough (アプリケーション ユーザー (パススルー))、 WebSiteWindowsAuth (Windows 認証)。 既定値: Application User (Pass-through)。

Web サイトの物理パスにアクセスするための認証メカニズムを指定します。

WebSiteAuthUserName - ユーザー名
string. WebSitePhysicalPathAuth = WebSiteWindowsAuth の場合に必要です。

Web サイトの物理パスにアクセスするためのユーザー名を指定します。

WebSiteAuthUserPassword - パスワード
string. 省略可能。 の場合は WebSitePhysicalPathAuth = WebSiteWindowsAuthを使用します。

Web サイトの物理パスにアクセスするためのパスワードを指定します。 gMSA を使用している場合、これは必須ではありません。

AddBinding - バインドの追加
boolean. 省略可能。 の場合は CreateWebSite = trueを使用します。 既定値: true。

Web サイトのポート バインドを追加するオプションを指定します。

AssignDuplicateBinding - 重複バインディングの割り当て
boolean. 省略可能。 の場合は AddBinding = trueを使用します。 既定値: false。

ここで指定したバインドを追加するオプションを指定します (同じバインドを持つ別の Web サイトがある場合でも)。 バインドの競合がある場合は、いずれかの Web サイトのみが開始されます。

Protocol - プロトコル
string. AddBinding = true の場合に必要です。 使用できる値: https、http。 既定値: http。

Web サイトに HTTP バインドを設定する場合は HTTP、Web サイトに Secure Sockets Layer (SSL) バインドを設定する場合は HTTPS を指定します。

IPAddress - IP アドレス
string. AddBinding = true の場合に必要です。 既定値: All Unassigned。

ユーザーが Web サイトへのアクセスに使用できる IP アドレスを指定します。 [ すべての未割り当て ] が選択されている場合、サイトは、ポート上のすべての IP アドレスと、サイトに指定されているオプションのホスト名に対する要求に応答します。 サーバー上の別のサイトが同じポートで特定の IP アドレスを持つバインドを持っている場合、サイトは要求に応答しません。

Port - ポート
string. AddBinding = true の場合に必要です。 既定値: 80。

ハイパーテキスト転送プロトコル スタック (HTTP.sys) がこの Web サイトに対して行われた要求を監視する必要があるポートを指定します。

ServerNameIndication - サーバー名の表示が必要です
boolean. 省略可能。 の場合は Protocol = httpsを使用します。 既定値: false。

Web サイトで Server Name Indication (SNI) を必要とするかどうかを決定します。 SNI は SSL プロトコルと TLS プロトコルを拡張して、クライアントが接続しようとしているホスト名を示します。 SNI を使用すると、異なる証明書を持つ、複数のセキュリティで保護された Web サイトが同じ IP アドレスを使用できます。

HostNameWithOutSNI - ホスト名
string. 省略可能。 の場合は ServerNameIndication = falseを使用します。

1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは IP アドレスではなくホスト名を使用して Web サイトにアクセスする必要があります。

HostNameWithHttp - ホスト名
string. 省略可能。 の場合は Protocol = httpを使用します。

1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは IP アドレスではなくホスト名を使用して Web サイトにアクセスする必要があります。

HostNameWithSNI - ホスト名
string. ServerNameIndication = true の場合に必要です。

1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは IP アドレスではなくホスト名を使用して Web サイトにアクセスする必要があります。

SSLCertThumbPrint - SSL 証明書のサムプリント
string. Protocol = https の場合に必要です。

Web サイトで使用する Secure Socket Layer 証明書のサムプリントを指定します。 証明書は、コンピューターに既にインストールされ、ローカル コンピューターの個人用ストアの下に存在する必要があります。

CreateAppPool - アプリケーション プールの作成または更新
boolean. 既定値: false。

アプリケーション プールを作成するか、既存のアプリケーション プールを更新するオプションを指定します。

AppPoolName - 名前
string. CreateAppPool = true の場合に必要です。

作成または更新する IIS アプリケーション プールの名前を指定します。 既存のアプリケーション プールは、指定された設定で更新されます。

DotNetVersion - .NET バージョン
string. CreateAppPool = true の場合に必要です。 許可値: v4.0、v2.0、No Managed Code。 既定値: v4.0。

このアプリケーション プールによって読み込まれる.NET Frameworkのバージョンを指定します。 このアプリケーション プールに割り当てられているアプリケーションにマネージド コードが含まれていない場合は、一覧から [ マネージド コードなし ] オプションを選択します。

PipeLineMode - マネージド パイプライン モード
string. CreateAppPool = true の場合に必要です。 使用できる値: Integrated、Classic。 既定値: Integrated。

マネージド パイプライン モードでは、IIS がマネージド コンテンツの要求を処理する方法を指定します。 クラシック モードは、アプリケーション プール内のアプリケーションを統合モードで実行できない場合にのみ使用します。

AppPoolIdentity - Id
string. CreateAppPool = true の場合に必要です。 使用できる値: ApplicationPoolIdentity、、 LocalService、 LocalSystem、 NetworkService、 SpecificUser (カスタム アカウント)。 既定値: ApplicationPoolIdentity。

アプリケーション プールのワーカー プロセスを実行するアカウントを構成します。 定義済みのセキュリティ アカウントのいずれかを指定するか、カスタム アカウントを構成します。

AppPoolUsername - 名
string. AppPoolIdentity = SpecificUser の場合に必要です。

AppPoolPassword - パスワード
string. 省略可能。 の場合は AppPoolIdentity = SpecificUserを使用します。

gMSA を使用している場合、これは必須ではありません。

AppCmdCommands - その他の AppCmd.exe コマンド
string.

Web サイトまたはアプリケーション プールのプロパティを設定するための追加 AppCmd.exe のコマンドを指定します。 複数のコマンドの場合は、行区切り記号を使用します。
例:
<アプリ プールを一覧表示する>
<list sites>

DeployInParallel - 並列でデプロイする
boolean. 既定値: true。

に true設定すると、Web アプリケーションはターゲット マシンに並列にデプロイされます。

ResourceFilteringMethod - 以下の条件でコンピューターを選択
string. 使用できる値: machineNames (マシン名)、 tags。 既定値: machineNames。

省略可能。 コンピューター名またはタグを指定して、コンピューターのサブセットを指定します。

MachineFilter - マシンへのデプロイ
string.

この入力はマシン グループに対してのみ有効であり、マシンまたは出力変数のフラット リストではまだサポートされていません。

や タグなどの dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 マシンの一覧を指定します ( など Role:DB; OS:Win8.1)。 複数のタグが指定されている場合、タスクは指定されたタグを持つすべてのマシンで実行されます。 Azure リソース グループの場合は、 のように ffweb, ffdb仮想マシンの名前を指定します。 既定では、すべてのマシンでタスクが実行されます。

タスク制御オプション

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

出力変数

[なし] :

解説

重要

このタスクは非推奨とされます。 WinRM を使用した IIS Web アプリの展開 - Viual Studio Marketplace を使用します。

要件

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