IISWebAppDeployment@1 – Tarefa de implementação da Aplicação Web do IIS (Preterida) v1

Utilize esta tarefa para implementar a Aplicação Web do IIS com o MSDeploy e, em seguida, crie ou atualize sites e conjuntos de aplicações.

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize a Implementação de Aplicações Web do IIS com o WinRM – Viual Studio Marketplace.

Utilize esta tarefa para implementar a Aplicação Web do IIS com o MSDeploy e, em seguida, crie ou atualize sites e conjuntos de aplicações.

Syntax

# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.
# IIS Web App deployment (Deprecated) v1
# Deploy by MSDeploy, create/update website & app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Entradas

EnvironmentName - Computadores
string. Obrigatório.

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs do computador, juntamente com portas. A porta predefinida baseia-se no protocolo selecionado, por exemplo dbserver.fabrikam.com , ou dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Também pode fornecer a variável de saída de outras tarefas, por exemplo $(variableName).


AdminUserName - Início de Sessão do Administração
string.

Especifica o início de sessão do administrador para os computadores de destino.


AdminPassword - Palavra-passe
string.

Especifica a palavra-passe de administrador para os computadores de destino. Pode aceitar variáveis definidas em definições de compilação/versão, como $(passwordVariable). Pode marcar o tipo de variável como secret para o proteger.


WinRMProtocol - Protocolo
string. Valores permitidos: Http, Https.

Especifica o protocolo utilizado para a ligação WinRM com os computadores. A predefinição é HTTPS.


TestCertificate - Certificado de Teste
boolean. Opcional. Utilize quando WinRMProtocol = Https. Valor predefinido: true.

Seleciona a opção para ignorar a validação da autenticidade do certificado do computador por uma autoridade de certificação fidedigna. O parâmetro é necessário para o protocolo WinRM HTTPS .


WebDeployPackage - Pacote de Implementação Web
string. Obrigatório.

Especifica a localização do ficheiro zip Da Implementação Web (MSDeploy) nos computadores de destino ou num caminho UNC como , \\BudgetIT\WebDeploy\WebDeployPackage.zip. O caminho UNC deve estar acessível à conta de administrador do computador. As variáveis de ambiente também são suportadas, como $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.


WebDeployParamFile - Ficheiro de Parâmetros de Implementação Web
string.

Especifica a localização do ficheiro de parâmetros nos computadores de destino ou num caminho UNC. O ficheiro de parâmetros é utilizado para substituir as definições de configuração da aplicação Web, como o nome da aplicação Web do IIS ou a base de dados cadeia de ligação.


OverRideParams - Substituir Parâmetros
string.

Os parâmetros aqui especificados irão substituir os parâmetros no ficheiro zip MSDeploy e no ficheiro de parâmetros. Para substituir mais do que um parâmetro, utilize um separador de linha.
Por exemplo, "IIS Web Application Name"="Fabrikam" ou "ConnectionString"="Server=localhost;Database=Fabrikam;".


CreateWebSite - Criar ou Atualizar Web site
boolean. Valor predefinido: false.

Especifica a opção para criar um site ou atualizar um site existente.


WebSiteName - Nome do Site
string. Necessário quando CreateWebSite = true.

Especifica o nome do site do IIS que será criado se não existir ou será atualizado se já estiver presente no servidor IIS. O nome do site deve ser o mesmo que o especificado no ficheiro de pacote zip de implementação Web. Se também for especificada uma definição de parâmetros de ficheiro de parâmetros e de substituição, o nome do site deve ser o mesmo que na definição de parâmetros de substituição.


WebSitePhysicalPath - Caminho Físico
string. Necessário quando CreateWebSite = true. Valor predefinido: %SystemDrive%\inetpub\wwwroot.

Especifica o caminho físico onde o conteúdo do site é armazenado. O conteúdo pode residir no computador local ou num diretório ou partilha remoto, como C:\Fabrikam ou \\ContentShare\Fabrikam.


WebSitePhysicalPathAuth - Autenticação de Caminho Físico
string. Necessário quando CreateWebSite = true. Valores permitidos: WebSiteUserPassThrough (Utilizador da Aplicação (Pass-through)), WebSiteWindowsAuth (Autenticação do Windows). Valor predefinido: Application User (Pass-through).

Especifica o mecanismo de autenticação para aceder ao caminho físico do site.


WebSiteAuthUserName - Nome de Utilizador
string. Necessário quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Especifica o nome de utilizador para aceder ao caminho físico do site.


WebSiteAuthUserPassword - Palavra-passe
string. Opcional. Utilize quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Especifica a palavra-passe para aceder ao caminho físico do site. Se estiver a utilizar uma gMSA, tal não é necessário.


AddBinding - Adicionar Enlace
boolean. Opcional. Utilize quando CreateWebSite = true. Valor predefinido: true.

Especifica a opção para adicionar o enlace de porta para o site.


AssignDuplicateBinding - Atribuir Enlace Duplicado
boolean. Opcional. Utilize quando AddBinding = true. Valor predefinido: false.

Especifica a opção para adicionar os enlaces especificados aqui (mesmo que exista outro site com os mesmos enlaces). Se existirem conflitos de enlace, apenas um dos sites será iniciado.


Protocol - Protocolo
string. Necessário quando AddBinding = true. Valores permitidos: https, http. Valor predefinido: http.

Especifica HTTP para o site ter um enlace HTTP ou HTTPS para que o site tenha um enlace SSL (Secure Sockets Layer).


IPAddress - Endereço IP
string. Necessário quando AddBinding = true. Valor predefinido: All Unassigned.

Especifica um endereço IP que os utilizadores podem utilizar para aceder ao site. Se Todos os Não Atribuídos estiverem selecionados , o site responderá aos pedidos de todos os endereços IP na porta e ao nome de anfitrião opcional especificado para o site. O site não responderá a pedidos se outro site no servidor tiver um enlace na mesma porta, mas com um endereço IP específico.


Port - Porta
string. Necessário quando AddBinding = true. Valor predefinido: 80.

Especifica a porta na qual a Pilha de Protocolos de Transferência de Hypertextos (HTTP.sys) tem de monitorizar os pedidos feitos a este site.


ServerNameIndication - Indicação do Nome do Servidor Necessária
boolean. Opcional. Utilize quando Protocol = https. Valor predefinido: false.

Determina se o site necessita de Indicação do Nome do Servidor (SNI). O SNI expande os protocolos SSL e TLS para indicar o nome do anfitrião ao qual o cliente está a tentar ligar-se. Permite que vários sites seguros com certificados diferentes utilizem o mesmo endereço IP.


HostNameWithOutSNI - Nome do Anfitrião
string. Opcional. Utilize quando ServerNameIndication = false.

Atribui um ou mais nomes de anfitrião (ou nomes de domínio) a um computador que utiliza um único endereço IP. Se for especificado um nome de anfitrião, os clientes têm de utilizar o nome do anfitrião em vez do endereço IP para aceder ao site.


HostNameWithHttp - Nome do Anfitrião
string. Opcional. Utilize quando Protocol = http.

Atribui um ou mais nomes de anfitrião (ou nomes de domínio) a um computador que utiliza um único endereço IP. Se for especificado um nome de anfitrião, os clientes têm de utilizar o nome do anfitrião em vez do endereço IP para aceder ao site.


HostNameWithSNI - Nome do Anfitrião
string. Necessário quando ServerNameIndication = true.

Atribui um ou mais nomes de anfitrião (ou nomes de domínio) a um computador que utiliza um único endereço IP. Se for especificado um nome de anfitrião, os clientes têm de utilizar o nome do anfitrião em vez do endereço IP para aceder ao site.


SSLCertThumbPrint - Impressão em Miniatura do Certificado SSL
string. Necessário quando Protocol = https.

Especifica a impressão digital do certificado Secure Socket Layer que o site vai utilizar. O certificado já deve estar instalado no computador e presente no arquivo Pessoal do Computador Local.


CreateAppPool - Criar ou Atualizar Conjunto Aplicacional
boolean. Valor predefinido: false.

Especifica a opção para criar um conjunto aplicacional ou atualizar um conjunto aplicacional existente.


AppPoolName - Nome
string. Necessário quando CreateAppPool = true.

Especifica o nome do conjunto aplicacional do IIS a criar ou atualizar. O conjunto aplicacional existente será atualizado com as definições especificadas.


DotNetVersion - Versão do .NET
string. Necessário quando CreateAppPool = true. Valores permitidos: v4.0, , v2.0No Managed Code. Valor predefinido: v4.0.

Especifica a versão do .NET Framework que é carregada por este conjunto aplicacional. Se as aplicações atribuídas a este conjunto aplicacional não tiverem código gerido, selecione a opção Sem Código Gerido na lista.


PipeLineMode - Modo de Pipeline Gerido
string. Necessário quando CreateAppPool = true. Valores permitidos: Integrated, Classic. Valor predefinido: Integrated.

O modo de pipeline gerido especifica a forma como o IIS processa os pedidos de conteúdo gerido. Utilize o modo clássico apenas quando as aplicações no conjunto aplicacional não puderem ser executadas no modo integrado.


AppPoolIdentity - Identidade
string. Necessário quando CreateAppPool = true. Valores permitidos: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService( SpecificUser Conta Personalizada). Valor predefinido: ApplicationPoolIdentity.

Configura a conta na qual é executado o processo de trabalho de um conjunto aplicacional. Especifique uma das contas de segurança predefinidas ou configure uma conta personalizada.


AppPoolUsername - Nome de utilizador
string. Necessário quando AppPoolIdentity = SpecificUser.


AppPoolPassword - Palavra-passe
string. Opcional. Utilize quando AppPoolIdentity = SpecificUser.

Se estiver a utilizar uma gMSA, isto não é necessário.


AppCmdCommands - Comandos de AppCmd.exe Adicionais
string.

Especifica comandos adicionais AppCmd.exe para definir as propriedades do site ou do conjunto aplicacional. Para mais do que um comando, utilize um separador de linha.
Por exemplo:
<listar conjuntos de aplicações>
<sites de lista>


DeployInParallel - Implementar em Paralelo
boolean. Valor predefinido: true.

Se estiver definida como true, a aplicação Web é implementada em paralelo nos computadores de destino.


ResourceFilteringMethod - Selecionar Máquinas Por
string. Valores permitidos: machineNames (Nomes das Máquinas), tags. Valor predefinido: machineNames.

Opcional. Especifica um subconjunto de máquinas ao fornecer nomes de máquinas ou etiquetas.


MachineFilter - Implementar em Computadores
string.

Esta entrada só é válida para grupos de máquinas e ainda não é suportada para uma lista simples de máquinas ou variáveis de saída.

Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 ou etiquetas, como Role:DB; OS:Win8.1. Se forem fornecidas várias etiquetas, a tarefa será executada em todos os computadores com as etiquetas especificadas. Para Grupos de Recursos do Azure, especifique o nome da máquina virtual, como ffweb, ffdb. A predefinição executa a tarefa em todos os computadores.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 1.91.0 ou superior
Categoria da tarefa Implementação