使用此任务通过 Web 部署部署网站或 Web 应用程序。
重要
此任务仅适用于经典管道。 改 用 WinRM 使用 IIS Web 应用部署 - Visual Studio Marketplace 。
语法
# 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
-
网站名称
string
。 必填。
指定计算机组计算机上的现有网站的名称。
VirtualApplication
-
虚拟应用程序
string
。
指定目标计算机上的现有 Azure 虚拟应用程序的名称。
Package
-
包或文件夹
string
。 必填。 默认值:$(System.DefaultWorkingDirectory)\**\*.zip
。
指定 MSBuild 或压缩存档文件生成的包或文件夹的文件路径。 支持变量( 生成 | 发布)和通配符。
SetParametersFile
-
SetParameters 文件
string
。
指定要使用的文件的路径 SetParameters.xml
。
RemoveAdditionalFilesFlag
-
在目标处删除其他文件
boolean
。 默认值:false
。
如果设置为
ExcludeFilesFromAppDataFlag
-
从 App_Data 文件夹中排除文件
boolean
。 默认值:false
。
如果设置为
TakeAppOfflineFlag
-
使应用脱机
boolean
。 默认值:false
。
通过在同步作开始之前将文件放在 app_offline.htm
其根目录中来选择使 Web 应用脱机的选项。 同步作成功完成后,会自动删除该文件。
AdditionalArguments
-
其他参数
string
。
指定部署 Azure Web 应用时要使用的其他 Web 部署参数。 例如,-disableLink:AppPoolExtension
或 -disableLink:ContentExtension
。
有关支持参数的完整列表,请参阅 Web 部署作设置。
XmlTransformation
-
XML 转换
boolean
。 默认值:false
。
对相应的*.Release.config
文件运行 XML 转换*.<EnvironmentName>.config
和*.config file
文件。 这些转换在变量替换之前应用。 XML 转换仅在 Windows 上受支持。
XmlVariableSubstitution
-
XML 变量替换
boolean
。 默认值:false
。
指定在生成或发布管道中定义的变量。 这些变量与key
任何配置文件name
和部分中的appSettings
applicationSettings
connectionStrings
或parameters.xml
条目匹配。 变量替换在配置转换后执行。
注释
如果在发布管道和环境中定义了相同的变量,则环境变量将优先于发布管道变量。
JSONFiles
-
JSON 变量替换
string
。
指定换行符的 JSON 文件换行列表。 文件名必须相对于根文件夹。
若要替换嵌套或分层 JSON 变量,请使用 JSONPath 表达式。 例如,若要替换以下示例中的值 ConnectionString
,请将变量 Data.DefaultConnection.ConnectionString
定义为生成或发布管道(或在发布管道的阶段)。
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
变量替换在配置转换后运行,管道变量将从替换中排除。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 “控制”选项和常见任务属性。
输出变量
没有。
注解
使用此任务通过 WebDeploy 部署网站或 Web 应用。