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

Artigo
03/24/2025

Use essa 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ório

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

de Aplicativo Virtual VirtualApplication -
string.

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

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

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

SetParametersFile - de arquivo SetParameters
string.

Opcional. Especifica o local do arquivo SetParameters.xml a 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 do da Pasta App_Data
boolean. Valor padrão: false.

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

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

Seleciona a opção de colocar o Aplicativo Web offline colocando um arquivo app_offline.htm no diretório raiz do Aplicativo Web antes do início da operação de sincronização. O arquivo será removido após a conclusão da operação de sincronização 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 Web Deploy Operation Settings.

XmlTransformation - de 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 de Variável. As transformações XML só têm suporte no Windows.

XmlVariableSubstitution - de 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 correspondidas às entradas key 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.

Observação: 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 - de 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.

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

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

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

Requisitos

Requisito	Descrição
Tipos de pipeline	Versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.104.1 ou superior
Categoria de tarefa	Implantar

Compartilhar via