このタスクを使用して、MSDeploy を使用して IIS Web アプリをデプロイし、Web サイトとアプリ プールを作成または更新します。
重要
このタスクは非推奨となり、2024 年 1 月 31 日に廃止されます。 WinRM を使用した IIS Web アプリのデプロイを使用する - Visual 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.
入力
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 Deploy (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 サイトのコンテンツが格納される物理パスを指定します。 コンテンツは、C:\Fabrikam
や \\ContentShare\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 を、Ssl (Secure Sockets Layer) バインディングを持つ場合は 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 サイトにサーバー名表示 (SNI) が必要かどうかを判断します。 SNI は SSL プロトコルと TLS プロトコルを拡張して、クライアントが接続しようとしているホスト名を示します。 これにより、異なる証明書を持つ複数のセキュリティで保護された Web サイトで同じ IP アドレスを使用できます。
HostNameWithOutSNI
-
ホスト名
string
。 任意
ServerNameIndication = false
するときに使用します。
1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
HostNameWithHttp
-
ホスト名
string
。 任意
Protocol = http
するときに使用します。
1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
HostNameWithSNI
-
ホスト名
string
。
ServerNameIndication = true
する場合に必要です。
1 つの IP アドレスを使用するコンピューターに 1 つ以上のホスト名 (またはドメイン名) を割り当てます。 ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
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
-
同一性
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
コマンドを指定します。 複数のコマンドの場合は、行区切り記号を使用します。
次に例を示します。
アプリ プール< の一覧を >する
サイト<>一覧表示する
並列デプロイ 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。