IISWebAppDeploymentOnMachineGroup@0 - IIS Web 应用部署 v0 任务

使用此任务通过 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

如果设置为 />,则删除 Web 应用 ZIP 包中没有匹配文件的 Web 应用上的文件。


ExcludeFilesFromAppDataFlag - 从 App_Data 文件夹中排除文件
boolean。 默认值:false

如果设置为 /a0>,这会阻止将文件夹中的文件 部署到 Web 应用。


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和部分中的appSettingsapplicationSettingsconnectionStringsparameters.xml条目匹配。 变量替换在配置转换后执行。

注释

如果在发布管道和环境中定义了相同的变量,则环境变量将优先于发布管道变量。


JSONFiles - JSON 变量替换
string

指定换行符的 JSON 文件换行列表。 文件名必须相对于根文件夹。

若要替换嵌套或分层 JSON 变量,请使用 JSONPath 表达式。 例如,若要替换以下示例中的值 ConnectionString ,请将变量 Data.DefaultConnection.ConnectionString 定义为生成或发布管道(或在发布管道的阶段)。

{  
  "Data": {  
    "DefaultConnection": {  
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"  
    }  
  }  
}

变量替换在配置转换后运行,管道变量将从替换中排除。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 “控制”选项和常见任务属性

输出变量

没有。

注解

使用此任务通过 WebDeploy 部署网站或 Web 应用。

例子

要求

要求 说明
管道类型 经典版本
运行时间 代理,DeploymentGroup
要求 没有
能力 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 2.104.1 或更高版本
任务类别 部署