IISWebAppDeploymentOnMachineGroup@0 – Tarefa de implantação do aplicativo Web do IIS v0

Use esta tarefa para implantar um site ou aplicativo Web usando a Implantação da Web.

Sintaxe

# 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.

Entradas

WebSiteName - Nome do Site
string. Obrigatórios.

Especifica o nome de um site existente nos computadores do grupo de computadores.

VirtualApplication - Aplicativo Virtual
string.

Especifica o nome de um aplicativo virtual do Azure já existente nas máquinas de destino.

Package - Pacote ou pasta
string. Obrigatórios. Valor padrão: $(System.DefaultWorkingDirectory)\**\*.zip.

Especifica o caminho do arquivo para o pacote ou pasta gerado pelo MSBuild ou um arquivo morto compactado. Há suporte para variáveis ( | versão de build) e curingas. Por exemplo, $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - Arquivo SetParameters
string.

Opcional. Especifica o local do arquivo a SetParameters.xml ser usado.

RemoveAdditionalFilesFlag - Remover arquivos adicionais no destino
boolean. Valor padrão: false.

Seleciona a opção de excluir arquivos no Aplicativo Web que não têm arquivos correspondentes no pacote zip do Aplicativo Web.

ExcludeFilesFromAppDataFlag - Excluir arquivos da pasta App_Data
boolean. Valor padrão: false.

Seleciona a opção para impedir que arquivos na App_Data pasta sejam implantados no Aplicativo Web.

TakeAppOfflineFlag - Tirar o aplicativo offline
boolean. Valor padrão: false.

Seleciona a opção de colocar o Aplicativo Web offline colocando um app_offline.htm arquivo no diretório raiz do Aplicativo Web antes do início da operação de sincronização. O arquivo será removido depois que a operação de sincronização for concluída com êxito.

AdditionalArguments - Argumentos adicionais
string.

Especifica argumentos adicionais de Implantação da Web que são aplicados ao implantar o Aplicativo Web do Azure. Por exemplo, -disableLink:AppPoolExtension ou -disableLink:ContentExtension.

Para obter uma lista de argumentos de Implantação da Web, consulte Configurações de Operação de Implantação da Web.

XmlTransformation - Transformação XML
boolean. Valor padrão: false.

Especifica as transformações de configuração executadas para *.Release.config e *.<EnvironmentName>.config no *.config file. As transformações de configuração são executadas antes da Substituição variável. As transformações XML só têm suporte no Windows.

XmlVariableSubstitution - Substituição de variável XML
boolean. Valor padrão: false.

Especifica as variáveis definidas no pipeline de build ou lançamento. Essas variáveis são correspondentes às key entradas ou name nas seções appSettings, applicationSettings e connectionStrings de qualquer arquivo de configuração e parameters.xml. A substituição de variável é executada após transformações de configuração.

Nota: Se as mesmas variáveis forem definidas no pipeline de lançamento e no ambiente, as variáveis de ambiente substituirão as variáveis de pipeline de lançamento.

JSONFiles - Substituição de variável JSON
string.

Especifica uma nova lista separada de linhas de arquivos JSON para substituir os valores de variável. Os nomes de arquivo devem ser relativos à pasta raiz.

Para substituir variáveis JSON aninhadas ou hierárquicas, especifique-as usando expressões JSONPath. Por exemplo, para substituir o valor de ConnectionString no exemplo abaixo, você deve definir uma variável como Data.DefaultConnection.ConnectionString no pipeline de build ou lançamento (ou no estágio do pipeline de lançamento).

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

A substituição de variável é executada após transformações de configuração.

Nota: As variáveis de pipeline são excluídas na substituição.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use esta tarefa para implantar um site ou aplicativo Web usando WebDeploy.

Requisitos

Requisito	Descrição
Tipos de pipeline	Versão clássica
É executado em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.104.1 ou superior
Categoria da tarefa	Implantar