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

[アーティクル]
08/19/2024

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

重要

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

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

重要

このタスクは非推奨とされます。 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.

# IIS Web App deployment (Deprecated) v1
# Deploy by MSDeploy, create/update website & 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を使用します。

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

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 以上
タスクのカテゴリ	配置

次の方法で共有

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

構文

入力

タスク制御オプション

出力変数

解説

要件

フィードバック

その他のリソース