Partilhar via


IISWebAppDeployment@1 - Tarefa de implantação do IIS Web App (Preterido) v1

Use esta tarefa para implantar o IIS Web App usando MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.

Importante

Esta tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use a implantação do IIS Web App usando o WinRM - Visual Studio Marketplace.

Use esta tarefa para implantar o IIS Web App usando MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.

Sintaxe

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

Insumos

EnvironmentName - Máquinas
string. Obrigatório.

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs da máquina, juntamente com portas. A porta padrão é baseada no protocolo selecionado, por exemplo, dbserver.fabrikam.com ou dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Você também pode fornecer a variável de saída de outras tarefas, por exemplo, $(variableName).


AdminUserName - de login de administrador
string.

Especifica o login de administrador para as máquinas de destino.


AdminPassword - Palavra-passe
string.

Especifica a senha de administrador para as máquinas de destino. Ele pode aceitar variáveis definidas em definições de compilação/versão, como $(passwordVariable). Você pode marcar o tipo de variável como secret para protegê-la.


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

Especifica o protocolo usado para a conexão do WinRM com a(s) máquina(s). A predefinição é HTTPS.


TestCertificate - Certificado de Teste
boolean. Opcional. Use quando WinRMProtocol = Https. Valor padrão: true.

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


WebDeployPackage - de pacotes de implantação da Web
string. Obrigatório.

Especifica o local do arquivo zip MSDeploy (Web Deploy) nas máquinas de destino ou em um caminho UNC como, \\BudgetIT\WebDeploy\WebDeployPackage.zip. O caminho UNC deve estar acessível à conta de administrador da máquina. Também há suporte para variáveis de ambiente, como $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.


WebDeployParamFile - de arquivo de parâmetro de implantação da Web
string.

Especifica o local do arquivo de parâmetro nas máquinas de destino ou em um caminho UNC. O arquivo de parâmetro é usado para substituir as definições de configuração do aplicativo Web, como o nome do aplicativo Web do IIS ou a cadeia de conexão do banco de dados.


OverRideParams - Substituir parâmetros
string.

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


CreateWebSite - Criar ou atualizar site
boolean. Valor padrão: false.

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


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

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


WebSitePhysicalPath - Caminho físico
string. Necessário quando CreateWebSite = true. Valor padrão: %SystemDrive%\inetpub\wwwroot.

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


WebSitePhysicalPathAuth - de autenticação de caminho físico
string. Necessário quando CreateWebSite = true. Valores permitidos: WebSiteUserPassThrough (Usuário do Aplicativo (Passagem)), WebSiteWindowsAuth (Autenticação do Windows). Valor padrão: Application User (Pass-through).

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


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

Especifica o nome de usuário para acessar o caminho físico do site.


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

Especifica a senha para acessar o caminho físico do site. Se você estiver usando um gMSA, isso não é necessário.


AddBinding - Adicionar vinculação
boolean. Opcional. Use quando CreateWebSite = true. Valor padrão: true.

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


AssignDuplicateBinding - Atribuir vinculação duplicada
boolean. Opcional. Use quando AddBinding = true. Valor padrão: false.

Especifica a opção para adicionar as associações especificadas aqui (mesmo que haja outro site com as mesmas associações). Se houver conflitos vinculativos, apenas um dos sites será iniciado.


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

Especifica HTTP para o site ter uma associação HTTP ou HTTPS para o site ter uma associação SSL (Secure Sockets Layer).


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

Especifica um endereço IP que os usuários podem usar para acessar o site. Se Todos os Não Atribuídos estiver selecionado, o site responderá às solicitações de todos os endereços IP na porta e o nome de host opcional especificado para o site. O site não responderá a solicitações se outro site no servidor tiver uma ligação na mesma porta, mas com um endereço IP específico.


Port - Porto
string. Necessário quando AddBinding = true. Valor padrão: 80.

Especifica a porta na qual o Hypertext Transfer Protocol Stack (HTTP.sys) deve monitorar as solicitações feitas a este site.


ServerNameIndication - Indicação de nome do servidor necessária
boolean. Opcional. Use quando Protocol = https. Valor padrão: false.

Determina se o site requer a Indicação de Nome do Servidor (SNI). O SNI estende os protocolos SSL e TLS para indicar a qual nome de host o cliente está tentando se conectar. Ele permite que vários sites seguros com diferentes certificados usem o mesmo endereço IP.


HostNameWithOutSNI - Nome do anfitrião
string. Opcional. Use quando ServerNameIndication = false.

Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes devem usar o nome do host em vez do endereço IP para acessar o site.


HostNameWithHttp - Nome do anfitrião
string. Opcional. Use quando Protocol = http.

Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes devem usar o nome do host em vez do endereço IP para acessar o site.


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

Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes devem usar o nome do host em vez do endereço IP para acessar o site.


SSLCertThumbPrint - de impressão digital do certificado SSL
string. Necessário quando Protocol = https.

Especifica a impressão digital do certificado Secure Socket Layer que o site vai usar. O certificado já deve estar instalado na máquina e presente no armazenamento pessoal do computador local.


CreateAppPool - Criar ou atualizar pool de aplicativos
boolean. Valor padrão: false.

Especifica a opção para criar um pool de aplicativos ou atualizar um pool de aplicativos existente.


AppPoolName - Designação
string. Necessário quando CreateAppPool = true.

Especifica o nome do pool de aplicativos do IIS a ser criado ou atualizado. O pool de aplicativos existente será atualizado com as configurações especificadas.


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

Especifica a versão do .NET Framework que é carregada por este pool de aplicativos. Se os aplicativos atribuídos a este pool de aplicativos não contiverem código gerenciado, selecione a opção Sem código gerenciado na lista.


PipeLineMode - Modo de pipeline gerenciado
string. Necessário quando CreateAppPool = true. Valores permitidos: Integrated, Classic. Valor padrão: Integrated.

O modo de pipeline gerenciado especifica como o IIS processa solicitações de conteúdo gerenciado. Use o modo clássico somente quando os aplicativos no pool de aplicativos não puderem ser executados no modo integrado.


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

Configura a conta sob a qual o processo de trabalho de um pool de aplicativos é executado. 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. Use quando AppPoolIdentity = SpecificUser.

Se você estiver usando um gMSA, isso não é necessário.


AppCmdCommands - Comandos AppCmd.exe adicionais
string.

Especifica comandos AppCmd.exe adicionais para definir as propriedades do site ou do pool de aplicativos. Para mais de um comando, use um separador de linha.
Por exemplo:
<listar pools de aplicativos>
<listar sites>


DeployInParallel - Implantar em paralelo
boolean. Valor padrão: true.

Se definido como true, o aplicativo Web é implantado em paralelo nas máquinas de destino.


ResourceFilteringMethod - Selecionar Máquinas Por
string. Valores permitidos: machineNames (Nomes de máquinas), tags. Valor padrão: machineNames.

Opcional. Especifica um subconjunto de máquinas fornecendo nomes de máquinas ou tags.


MachineFilter - Implantar em máquinas
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 máquinas, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 ou tags, como Role:DB; OS:Win8.1. Se várias tags forem fornecidas, a tarefa será executada em todas as máquinas com as tags especificadas. Para Grupos de Recursos do Azure, especifique o nome da máquina virtual, como ffweb, ffdb. O padrão executa a tarefa em todas as máquinas.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.91.0 ou superior
Categoria de tarefa Desplegar