このタスクを使用して、Web サイト、Web アプリ、仮想ディレクトリ、またはアプリケーション プールを作成または更新します。
構文
# IIS web app manage v0
# Create or update websites, web apps, virtual directories, or application pools.
- task: IISWebAppManagementOnMachineGroup@0
inputs:
#EnableIIS: false # boolean. Enable IIS. Default: false.
IISDeploymentType: 'IISWebsite' # 'IISWebsite' | 'IISWebApplication' | 'IISVirtualDirectory' | 'IISApplicationPool'. Required. Configuration type. Default: IISWebsite.
ActionIISWebsite: 'CreateOrUpdateWebsite' # 'CreateOrUpdateWebsite' | 'StartWebsite' | 'StopWebsite'. Required when IISDeploymentType = IISWebsite. Action. Default: CreateOrUpdateWebsite.
#ActionIISApplicationPool: 'CreateOrUpdateAppPool' # 'CreateOrUpdateAppPool' | 'StartAppPool' | 'StopAppPool' | 'RecycleAppPool'. Required when IISDeploymentType = IISApplicationPool. Action. Default: CreateOrUpdateAppPool.
#StartStopWebsiteName: # string. Required when ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite. Website name.
#Protocol: 'http' # 'https' | 'http'. Required when IISDeploymentType = randomDeployment. Protocol. Default: http.
#IPAddress: 'All Unassigned' # string. Required when IISDeploymentType = randomDeployment. IP address. Default: All Unassigned.
#Port: '80' # string. Required when IISDeploymentType = randomDeployment. Port. Default: 80.
#ServerNameIndication: false # boolean. Optional. Use when IISDeploymentType = randomDeployment. Server Name Indication required. Default: false.
#HostNameWithOutSNI: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name.
#HostNameWithHttp: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name.
#HostNameWithSNI: # string. Required when IISDeploymentType = randomDeployment. Host name.
#SSLCertThumbPrint: # string. Required when IISDeploymentType = randomDeployment. SSL certificate thumbprint.
#StartStopRecycleAppPoolName: # string. Required when ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool. Application pool name.
# IIS Website
WebsiteName: # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Website name.
WebsitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
WebsitePhysicalPathAuth: 'WebsiteUserPassThrough' # 'WebsiteUserPassThrough' | 'WebsiteWindowsAuth'. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path authentication. Default: WebsiteUserPassThrough.
#WebsiteAuthUserName: # string. Required when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Username.
#WebsiteAuthUserPassword: # string. Optional. Use when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Password.
#AddBinding: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Add binding. Default: false.
#CreateOrUpdateAppPoolForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Create or update app pool. Default: false.
#ConfigureAuthenticationForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Configure authentication. Default: false.
# IIS Bindings
#Bindings: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true. Add bindings.
# IIS Application pool
#AppPoolNameForWebsite: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Name.
#DotNetVersionForWebsite: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. .NET version. Default: v4.0.
#PipeLineModeForWebsite: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Managed pipeline mode. Default: Integrated.
#AppPoolIdentityForWebsite: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Identity. Default: ApplicationPoolIdentity.
#AppPoolUsernameForWebsite: # string. Required when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Username.
#AppPoolPasswordForWebsite: # string. Optional. Use when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Password.
# IIS Authentication
#AnonymousAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Anonymous authentication. Default: false.
#BasicAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Basic authentication. Default: false.
#WindowsAuthenticationForWebsite: true # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Windows authentication. Default: true.
# IIS Virtual directory
#ParentWebsiteNameForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Parent website name.
#VirtualPathForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Virtual path.
#PhysicalPathForVD: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISVirtualDirectory. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
#VDPhysicalPathAuth: 'VDUserPassThrough' # 'VDUserPassThrough' | 'VDWindowsAuth'. Optional. Use when IISDeploymentType = IISVirtualDirectory. Physical path authentication. Default: VDUserPassThrough.
#VDAuthUserName: # string. Required when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Username.
#VDAuthUserPassword: # string. Optional. Use when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Password.
# IIS Application
#ParentWebsiteNameForApplication: # string. Required when IISDeploymentType = IISWebApplication. Parent website name.
#VirtualPathForApplication: # string. Required when IISDeploymentType = IISWebApplication. Virtual path.
#PhysicalPathForApplication: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISWebApplication. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
#ApplicationPhysicalPathAuth: 'ApplicationUserPassThrough' # 'ApplicationUserPassThrough' | 'ApplicationWindowsAuth'. Optional. Use when IISDeploymentType = IISWebApplication. Physical path authentication. Default: ApplicationUserPassThrough.
#ApplicationAuthUserName: # string. Required when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Username.
#ApplicationAuthUserPassword: # string. Optional. Use when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Password.
#CreateOrUpdateAppPoolForApplication: false # boolean. Optional. Use when IISDeploymentType = IISWebApplication. Create or update app pool. Default: false.
# IIS Application pool
#AppPoolNameForApplication: # string. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Name.
#DotNetVersionForApplication: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. .NET version. Default: v4.0.
#PipeLineModeForApplication: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Managed pipeline mode. Default: Integrated.
#AppPoolIdentityForApplication: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Identity. Default: ApplicationPoolIdentity.
#AppPoolUsernameForApplication: # string. Required when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Username.
#AppPoolPasswordForApplication: # string. Optional. Use when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Password.
# IIS Application pool
AppPoolName: # string. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Name.
DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. .NET version. Default: v4.0.
PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Managed pipeline mode. Default: Integrated.
AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Identity. Default: ApplicationPoolIdentity.
#AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Username.
#AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Password.
# Advanced
#AppCmdCommands: # string. Additional appcmd.exe commands.
入力
EnableIIS
-
IIS を有効にする
boolean
. 既定値: false
.
コンピューターに IIS をインストールする場合は、true
に設定します。
IISDeploymentType
-
構成の種類
string
. 必須。 使用できる値: IISWebsite
(IIS Web サイト)、IISWebApplication
(IIS Web アプリケーション)、IISVirtualDirectory
(IIS 仮想ディレクトリ)、IISApplicationPool
(IIS アプリケーション プール)。 既定値: IISWebsite
.
構成の種類 (Web サイト、Web アプリケーション、仮想ディレクトリ、またはアプリケーション プール) を指定します。
ActionIISWebsite
-
アクションの
string
.
IISDeploymentType = IISWebsite
する場合に必要です。 使用できる値: CreateOrUpdateWebsite
(作成または更新)、StartWebsite
(開始)、StopWebsite
(停止)。 既定値: CreateOrUpdateWebsite
.
IIS Web サイトで実行する適切なアクションを指定します。
作成または更新 は、Web サイトを作成するか、既存の Web サイトを更新します。
開始、停止 は、それぞれ Web サイトを開始または停止します。
ActionIISApplicationPool
-
アクションの
string
.
IISDeploymentType = IISApplicationPool
する場合に必要です。 使用できる値: CreateOrUpdateAppPool
(作成または更新)、StartAppPool
(開始)、StopAppPool
(停止)、RecycleAppPool
(リサイクル)。 既定値: CreateOrUpdateAppPool
.
IIS アプリケーション プールに対して実行する適切なアクションを指定します。
の作成または更新、アプリケーション プールを作成するか、既存のアプリケーション プールを更新します。
開始、停止、リサイクル は、それぞれアプリケーション プールを開始、停止、またはリサイクルします。
StartStopWebsiteName
-
Web サイト名の
string
.
ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite
する場合に必要です。
IIS Web サイトの名前を指定します。
WebsiteName
-
Web サイト名の
string
.
ActionIISWebsite = CreateOrUpdateWebsite
する場合に必要です。
作成または更新する IIS Web サイトの名前を指定します。
物理パスの WebsitePhysicalPath
-
string
.
ActionIISWebsite = CreateOrUpdateWebsite
する場合に必要です。 既定値: %SystemDrive%\inetpub\wwwroot
.
Web サイトのコンテンツを格納する物理パスを指定します。 コンテンツは、ローカル コンピューター、リモート ディレクトリ、またはネットワーク共有 (C:\Fabrikam
や \\ContentShare\Fabrikam
など) に配置できます。
物理パス認証の WebsitePhysicalPathAuth
-
string
.
ActionIISWebsite = CreateOrUpdateWebsite
する場合に必要です。 使用できる値: WebsiteUserPassThrough
(アプリケーション ユーザー (パススルー))、WebsiteWindowsAuth
(Windows 認証)。 既定値: WebsiteUserPassThrough
.
Web サイトの物理パスへのアクセスに使用する認証メカニズムを指定します。
WebsiteAuthUserName
-
ユーザー名の
string
.
WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite
する場合に必要です。
Web サイトの物理パスへのアクセスに使用するユーザー名を指定します。
WebsiteAuthUserPassword
-
パスワード
string
. 任意
WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite
するときに使用します。
Web サイトの物理パスへのアクセスに使用するユーザーのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
AddBinding
-
バインド を追加する
boolean
. 任意
ActionIISWebsite = CreateOrUpdateWebsite
するときに使用します。 既定値: false
.
Web サイトのポート バインドを追加するオプションを指定します。
Protocol
-
プロトコル
string
.
IISDeploymentType = randomDeployment
する場合に必要です。 使用できる値: https
、http
。 既定値: http
.
Web サイトが HTTP バインディングを持つ場合は HTTP を、Ssl (Secure Sockets Layer) バインディングを持つ場合は HTTPS を指定します。
IPAddress
-
IP アドレスの
string
.
IISDeploymentType = randomDeployment
する場合に必要です。 既定値: All Unassigned
.
エンド ユーザーがこの Web サイトへのアクセスに使用できる IP アドレスを指定します。
[割り当てられていないすべての] が選択されている場合、Web サイトは、ポート上のすべての IP アドレスとホスト名に対する要求に応答します。 サーバー上の別の Web サイトが同じポートにバインドされているが、特定の IP アドレスを持つ場合、Web サイトは要求に応答しません。
Port
-
ポート
string
.
IISDeploymentType = randomDeployment
する場合に必要です。 既定値: 80
.
ハイパーテキスト転送プロトコル スタック (HTTP.sys) が Web サイト要求を監視するポートを指定します。
ServerNameIndication
-
サーバー名表示が必要な
boolean
. 任意
IISDeploymentType = randomDeployment
するときに使用します。 既定値: false
.
Web サイトのサーバー名表示 (SNI) を設定するオプションを指定します。
SNI は SSL プロトコルと TLS プロトコルを拡張して、クライアントが接続しようとしているホスト名を示します。 これにより、異なる証明書を持つ複数のセキュリティで保護された Web サイトで同じ IP アドレスを使用できます。
HostNameWithOutSNI
-
ホスト名の
string
. 任意
IISDeploymentType = randomDeployment
するときに使用します。
Web サイトのホスト名 (またはドメイン名) を指定します。
ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
HostNameWithHttp
-
ホスト名の
string
. 任意
IISDeploymentType = randomDeployment
するときに使用します。
Web サイトのホスト名 (またはドメイン名) を指定します。
ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
HostNameWithSNI
-
ホスト名の
string
.
IISDeploymentType = randomDeployment
する場合に必要です。
Web サイトのホスト名 (またはドメイン名) を指定します。
ホスト名が指定されている場合、クライアントは WEB サイトにアクセスするために IP アドレスの代わりにホスト名を使用する必要があります。
SSL 証明書の拇印を SSLCertThumbPrint
- する
string
.
IISDeploymentType = randomDeployment
する場合に必要です。
Web サイトが HTTPS 通信に使用する Secure Socket Layer 証明書のサムプリントを指定します。 サムプリントは 40 文字の長い 16 進文字列です。 SSL 証明書は、ローカル コンピューターの個人用ストアのコンピューターに既にインストールされている必要があります。
Bindings
-
バインド を追加する
string
.
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true
する場合に必要です。
Web サイトのバインドを指定します。
YAML のバインド構成の例を次に示します。
Bindings: |
{
bindings:[
{
"protocol":"https",
"ipAddress":"",
"hostname":"my.hostname.com",
"port":"443",
"sslThumbprint":"",
"sniFlag":true
}
]
}
CreateOrUpdateAppPoolForWebsite
-
アプリ プール の作成または更新
boolean
. 任意
ActionIISWebsite = CreateOrUpdateWebsite
するときに使用します。 既定値: false
.
アプリケーション プールを作成または更新するオプションを指定します。 オンにすると、指定したアプリケーション プールに Web サイトが作成されます。
ConfigureAuthenticationForWebsite
-
認証 を構成する
boolean
. 任意
ActionIISWebsite = CreateOrUpdateWebsite
するときに使用します。 既定値: false
.
Web サイトの認証を構成するオプションを指定します。
AppPoolNameForWebsite
-
名の
string
.
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
する場合に必要です。
作成または更新する IIS アプリケーション プールの名前を指定します。
.NET バージョンのを DotNetVersionForWebsite
- する
string
.
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
する場合に必要です。 使用できる値: v4.0
、v2.0
、No Managed Code
。 既定値: v4.0
.
アプリケーション プールによって読み込まれる .NET Framework のバージョンを指定します。 このアプリケーション プールに割り当てられているアプリケーションにマネージド コードが含まれていない場合は、一覧から [マネージド コードなし] オプションを選択します。
マネージド パイプライン モードの PipeLineModeForWebsite
-
string
.
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
する場合に必要です。 使用できる値: Integrated
、Classic
。 既定値: Integrated
.
IIS がマネージド コンテンツの要求を処理する方法を決定するマネージド パイプライン モードを指定します。 クラシック モードは、アプリケーション プール内のアプリケーションを統合モードで実行できない場合にのみ使用します。
AppPoolIdentityForWebsite
-
ID
string
.
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
する場合に必要です。 使用できる値: ApplicationPoolIdentity
(アプリケーション プール ID)、LocalService
(ローカル サービス)、LocalSystem
(ローカル システム)、NetworkService
(ネットワーク サービス)、SpecificUser
(カスタム アカウント)。 既定値: ApplicationPoolIdentity
.
アプリケーション プールのワーカー プロセスを実行するアカウントを構成します。 定義済みのセキュリティ アカウントのいずれかを指定するか、カスタム アカウントを構成します。
AppPoolUsernameForWebsite
-
ユーザー名の
string
.
AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
する場合に必要です。
使用するカスタム アカウントのユーザー名を指定します。
AppPoolPasswordForWebsite
-
パスワード
string
. 任意
AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
するときに使用します。
カスタム アカウントのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
匿名認証の AnonymousAuthenticationForWebsite
-
boolean
. 任意
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
するときに使用します。 既定値: false
.
Web サイトの匿名認証を有効にするオプションを指定します。
基本認証の BasicAuthenticationForWebsite
-
boolean
. 任意
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
するときに使用します。 既定値: false
.
Web サイトの基本認証を有効にするオプションを指定します。
Windows 認証を WindowsAuthenticationForWebsite
- する
boolean
. 任意
IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
するときに使用します。 既定値: true
.
Web サイトの Windows 認証を有効にするオプションを指定します。
ParentWebsiteNameForVD
-
親 Web サイト名の
string
.
IISDeploymentType = IISVirtualDirectory
する場合に必要です。
仮想ディレクトリの親 Web サイトの名前を指定します。
VirtualPathForVD
-
仮想パスの
string
.
IISDeploymentType = IISVirtualDirectory
する場合に必要です。
仮想ディレクトリの仮想パスを指定します。
たとえば、仮想ディレクトリ Site/Application/VDir
を作成するには、「/Application/Vdir
」と入力します。 親 Web サイトとアプリケーションは既に存在している必要があります。
物理パスの PhysicalPathForVD
-
string
.
IISDeploymentType = IISVirtualDirectory
する場合に必要です。 既定値: %SystemDrive%\inetpub\wwwroot
.
仮想ディレクトリのコンテンツが格納される物理パスを指定します。 コンテンツは、ローカル コンピューター、リモート ディレクトリ、またはネットワーク共有 (C:\Fabrikam
や \\ContentShare\Fabrikam
など) に配置できます。
物理パス認証の VDPhysicalPathAuth
-
string
. 任意
IISDeploymentType = IISVirtualDirectory
するときに使用します。 使用できる値: VDUserPassThrough
(アプリケーション ユーザー (パススルー))、VDWindowsAuth
(Windows 認証)。 既定値: VDUserPassThrough
.
仮想ディレクトリの物理パスへのアクセスに使用する認証メカニズムを指定します。
VDAuthUserName
-
ユーザー名の
string
.
VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory
する場合に必要です。
仮想ディレクトリの物理パスへのアクセスに使用するユーザー名を指定します。
VDAuthUserPassword
-
パスワード
string
. 任意
VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory
するときに使用します。
仮想ディレクトリの物理パスへのアクセスに使用するユーザーのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
ParentWebsiteNameForApplication
-
親 Web サイト名の
string
.
IISDeploymentType = IISWebApplication
する場合に必要です。
アプリケーションを作成または更新する親 Web サイトの名前を指定します。
VirtualPathForApplication
-
仮想パスの
string
.
IISDeploymentType = IISWebApplication
する場合に必要です。
アプリケーションの仮想パスを指定します。
たとえば、アプリケーション Site/Application
を作成するには、「/Application
」と入力します。 親 Web サイトは既に存在している必要があります。
物理パスの PhysicalPathForApplication
-
string
.
IISDeploymentType = IISWebApplication
する場合に必要です。 既定値: %SystemDrive%\inetpub\wwwroot
.
アプリケーションのコンテンツが格納される物理パスを指定します。 コンテンツは、ローカル コンピューター、リモート ディレクトリ、またはネットワーク共有 (C:\Fabrikam
や \\ContentShare\Fabrikam
など) に配置できます。
物理パス認証の ApplicationPhysicalPathAuth
-
string
. 任意
IISDeploymentType = IISWebApplication
するときに使用します。 使用できる値: ApplicationUserPassThrough
(アプリケーション ユーザー (パススルー))、ApplicationWindowsAuth
(Windows 認証)。 既定値: ApplicationUserPassThrough
.
アプリケーションの物理パスへのアクセスに使用する認証メカニズムを指定します。
ApplicationAuthUserName
-
ユーザー名の
string
.
ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication
する場合に必要です。
アプリケーションの物理パスへのアクセスに使用するユーザー名を指定します。
ApplicationAuthUserPassword
-
パスワード
string
. 任意
ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication
するときに使用します。
アプリケーションの物理パスへのアクセスに使用するユーザーのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
CreateOrUpdateAppPoolForApplication
-
アプリ プール の作成または更新
boolean
. 任意
IISDeploymentType = IISWebApplication
するときに使用します。 既定値: false
.
アプリケーション プールを作成または更新するオプションを指定します。 オンにすると、指定したアプリケーション プールにアプリケーションが作成されます。
AppPoolNameForApplication
-
名の
string
.
IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
する場合に必要です。
作成または更新する IIS アプリケーション プールの名前を指定します。
.NET バージョンのを DotNetVersionForApplication
- する
string
.
IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
する場合に必要です。 使用できる値: v4.0
、v2.0
、No Managed Code
。 既定値: v4.0
.
アプリケーション プールによって読み込まれる .NET Framework のバージョンを指定します。 このアプリケーション プールに割り当てられているアプリケーションにマネージド コードが含まれていない場合は、一覧から [マネージド コードなし] オプションを選択します。
マネージド パイプライン モードの PipeLineModeForApplication
-
string
.
IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
する場合に必要です。 使用できる値: Integrated
、Classic
。 既定値: Integrated
.
IIS がマネージド コンテンツの要求を処理する方法を決定するマネージド パイプライン モードを指定します。 クラシック モードは、アプリケーション プール内のアプリケーションを統合モードで実行できない場合にのみ使用します。
AppPoolIdentityForApplication
-
ID
string
.
IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
する場合に必要です。 使用できる値: ApplicationPoolIdentity
(アプリケーション プール ID)、LocalService
(ローカル サービス)、LocalSystem
(ローカル システム)、NetworkService
(ネットワーク サービス)、SpecificUser
(カスタム アカウント)。 既定値: ApplicationPoolIdentity
.
アプリケーション プールのワーカー プロセスを実行するアカウントを構成します。 定義済みのセキュリティ アカウントのいずれかを指定するか、カスタム アカウントを構成します。
AppPoolUsernameForApplication
-
ユーザー名の
string
.
AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
する場合に必要です。
使用するカスタム アカウントのユーザー名を指定します。
AppPoolPasswordForApplication
-
パスワード
string
. 任意
AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
するときに使用します。
カスタム アカウントのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
AppPoolName
-
名の
string
.
ActionIISApplicationPool = CreateOrUpdateAppPool
する場合に必要です。
作成または更新する IIS アプリケーション プールの名前を指定します。
.NET バージョンのを DotNetVersion
- する
string
.
ActionIISApplicationPool = CreateOrUpdateAppPool
する場合に必要です。 使用できる値: v4.0
、v2.0
、No Managed Code
。 既定値: v4.0
.
アプリケーション プールによって読み込まれる .NET Framework のバージョンを指定します。 このアプリケーション プールに割り当てられているアプリケーションにマネージド コードが含まれていない場合は、一覧から [マネージド コードなし] オプションを選択します。
マネージド パイプライン モードの PipeLineMode
-
string
.
ActionIISApplicationPool = CreateOrUpdateAppPool
する場合に必要です。 使用できる値: Integrated
、Classic
。 既定値: Integrated
.
IIS がマネージド コンテンツの要求を処理する方法を決定するマネージド パイプライン モードを指定します。 クラシック モードは、アプリケーション プール内のアプリケーションを統合モードで実行できない場合にのみ使用します。
AppPoolIdentity
-
ID
string
.
ActionIISApplicationPool = CreateOrUpdateAppPool
する場合に必要です。 使用できる値: ApplicationPoolIdentity
(アプリケーション プール ID)、LocalService
(ローカル サービス)、LocalSystem
(ローカル システム)、NetworkService
(ネットワーク サービス)、SpecificUser
(カスタム アカウント)。 既定値: ApplicationPoolIdentity
.
アプリケーション プールのワーカー プロセスを実行するアカウントを構成します。 定義済みのセキュリティ アカウントのいずれかを指定するか、カスタム アカウントを構成します。
AppPoolUsername
-
ユーザー名の
string
.
AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool
する場合に必要です。
使用するカスタム アカウントのユーザー名を指定します。
AppPoolPassword
-
パスワード
string
. 任意
AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool
するときに使用します。
カスタム アカウントのパスワードを指定します。
ベスト プラクティスは、ビルドまたはリリース パイプラインに変数を作成し、それをセキュリティで保護するための Secret
としてマークし、$(userCredentials)
のように、この入力を使用するときに指定することです。
注: パスワードの特殊文字は、コマンドライン引数ごとに解釈されます。
StartStopRecycleAppPoolName
-
アプリケーション プール名の
string
.
ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool
する場合に必要です。
IIS アプリケーション プールの名前を指定します。
AppCmdCommands
-
その他の appcmd.exe コマンド
string
.
追加の AppCmd.exe
コマンドを指定します。 複数のコマンドの場合は、行区切り記号を使用します。
次に例を示します。
list apppools
list sites
recycle apppool /apppool.name:ExampleAppPoolName
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、Web サイト、Web アプリ、仮想ディレクトリ、またはアプリケーション プールを作成または更新します。