IISWebAppDeploymentOnMachineGroup@0 - IIS web app deploy v0 task

Use this task to deploy a website or web application using Web Deploy.

# 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 - Website Name
string. Required.

Specifies the name of an existing website on the machine group machines.

VirtualApplication - Virtual Application
string.

Specifies the name of an existing Azure Virtual application on the target machines.

Package - Package or Folder
string. Required. Default: $(System.DefaultWorkingDirectory)\**\*.zip.

Specifies the file path to the package or folder generated by MSBuild or to a compressed archive file. Variables ( Build | Release) and wildcards are supported.

SetParametersFile - SetParameters File
string. Optional.

Specifies the path to the SetParameters.xml file to be used.

RemoveAdditionalFilesFlag - Remove Additional Files at Destination
boolean. Default: false.

If set to true, deletes files on the Web App that don’t have matching files in the Web App ZIP package.

ExcludeFilesFromAppDataFlag - Exclude Files from the App_Data Folder
boolean. Default: false.

If set to true, this prevents files in the App_Data folder from being deployed to the Web App.

TakeAppOfflineFlag - Take App Offline
boolean. Default: false.

Selects the option to take the Web App offline by placing an app_offline.htm file in its root directory before the sync operation begins. The file is automatically removed after the sync operation completes successfully.

AdditionalArguments - Additional Arguments
string.

Specifies additional Web Deploy arguments to use when deploying the Azure Web App. For example, -disableLink:AppPoolExtension or -disableLink:ContentExtension.

For a full list of supported arguments, see Web Deploy Operation Settings.

XmlTransformation - XML transformation
boolean. Default: false.

Runs XML transformations for *.Release.config and *.<EnvironmentName>.config files on the corresponding *.config file. These transformations are applied before variable substitution. XML transformations are supported only on Windows.

XmlVariableSubstitution - XML variable substitution
boolean. Default: false.

Specifies the variables defined in the build or release pipeline. These variables are matched against the key or name entries in the appSettings, applicationSettings, and connectionStrings sections of any config file and parameters.xml. Variable Substitution is performed after config transformations.

JSONFiles - JSON variable substitution
string.

Specifies a newline-separated list of JSON files for variable substitution. File names must be relative to the root folder.

To substitute nested or hierarchical JSON variables, use JSONPath expressions. For example, to replace the value of ConnectionString in the sample below, define a variable as Data.DefaultConnection.ConnectionString in the build or release pipeline (or in the release pipeline's stage).

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

Variable substitution is run after configuration transforms, and pipeline variables are excluded from substitution.

None.