Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para implantar o IIS Web App usando o MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.
Importante
Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use a implantação de aplicativo Web do IIS usando o WinRM – Visual Studio Marketplace.
Use essa tarefa para implantar o IIS Web App usando o MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.
Importante
Essa tarefa foi preterida. Use a implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.
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.
Entradas
máquinas EnvironmentName -
string. Obrigatório
Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, 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
-
Logon do Administrador
string.
Especifica o logon do administrador para os computadores de destino.
AdminPassword
-
de senha
string.
Especifica a senha do administrador para os computadores de destino. Ele pode aceitar variáveis definidas em definições de build/versão, como $(passwordVariable). Você pode marcar o tipo de variável como secret para protegê-lo.
WinRMProtocol
-
Protocolo
string. Valores permitidos: Http, Https.
Especifica o protocolo usado para a conexão WinRM com os computadores. O padrão é HTTPS.
TestCertificate
-
de certificado de teste
boolean. Opcional. Use quando WinRMProtocol = Https. Valor padrão: true.
Seleciona a opção de ignorar a validação da autenticidade do certificado do computador por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo HTTPS WinRM.
WebDeployPackage
-
Pacote de Implantação da Web
string. Obrigatório
Especifica o local do arquivo zip de Implantação da Web (MSDeploy) nos computadores de destino ou em um caminho UNC como, \\BudgetIT\WebDeploy\WebDeployPackage.zip. O caminho UNC deve estar acessível à conta de administrador do computador. Também há suporte para variáveis de ambiente, como $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.
WebDeployParamFile
-
Arquivo de parâmetro de implantação da Web
string.
Especifica o local do arquivo de parâmetro nos computadores de destino ou em um caminho UNC. O arquivo de parâmetro é usado para substituir as configurações de aplicativo Web, como o nome do aplicativo Web do IIS ou a cadeia de conexão de 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âmetro. 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 de 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 ele não existir ou será atualizado se ele 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 parâmetros de substituição e arquivo de parâmetros de parâmetros também for especificada, o nome do site deverá ser o mesmo que na 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 em que o conteúdo do site é armazenado. O conteúdo pode residir no computador local ou em um diretório ou compartilhamento remoto, 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 Usuário
string. Necessário quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.
Especifica o nome de usuário para acessar o caminho físico do site.
WebSiteAuthUserPassword
-
de senha
string. Opcional. Use quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.
Especifica a senha para acessar o caminho físico do site. Se você estiver usando uma gMSA, isso não será necessário.
AddBinding
-
Adicionar Associação
boolean. Opcional. Use quando CreateWebSite = true. Valor padrão: true.
Especifica a opção de adicionar associação de porta para o site.
AssignDuplicateBinding
-
Atribuir associação duplicada
boolean. Opcional. Use quando AddBinding = true. Valor padrão: false.
Especifica a opção de adicionar as associações especificadas aqui (mesmo que haja outro site com as mesmas associações). Se houver conflitos de associação, 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 que o site tenha 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 All Unassigned estiver selecionado, o site responderá às solicitações de todos os endereços IP na porta e ao nome do host opcional especificado para o site. O site não responderá às solicitações se outro site no servidor tiver uma associação na mesma porta, mas com um endereço IP específico.
porta Port -
string. Necessário quando AddBinding = true. Valor padrão: 80.
Especifica a porta na qual a Pilha de Protocolos de Transferência de Hipertexto (HTTP.sys) deve monitorar as solicitações feitas para 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 SNI (Indicação de Nome do Servidor). 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 certificados diferentes usem o mesmo endereço IP.
HostNameWithOutSNI
-
Nome do host
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 deverão usar o nome do host em vez do endereço IP para acessar o site.
HostNameWithHttp
-
Nome do host
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 deverão usar o nome do host em vez do endereço IP para acessar o site.
HostNameWithSNI
-
Nome do host
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 deverão 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 camada de soquete seguro que o site usará. O certificado já deve estar instalado no computador e estar presente no repositório Pessoal do Computador Local.
CreateAppPool
-
Criar ou atualizar o pool de aplicativos
boolean. Valor padrão: false.
Especifica a opção de criar um pool de aplicativos ou atualizar um pool de aplicativos existente.
AppPoolName
-
Nome
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
-
de versão do .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 carregada por esse pool de aplicativos. Se os aplicativos atribuídos a esse 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 na 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
-
de nome de usuário
string. Necessário quando AppPoolIdentity = SpecificUser.
AppPoolPassword
-
de senha
string. Opcional. Use quando AppPoolIdentity = SpecificUser.
Se você estiver usando uma gMSA, isso não será necessário.
AppCmdCommands
-
Comandos de AppCmd.exe adicionais
string.
Especifica comandos de 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>
<sites de lista>
DeployInParallel
-
Implantar em Paralelo
boolean. Valor padrão: true.
Se definido como true, o aplicativo Web será implantado em paralelo nos computadores de destino.
ResourceFilteringMethod
-
Selecionar computadores por
string. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.
Opcional. Especifica um subconjunto de computadores fornecendo nomes de computador ou marcas.
MachineFilter
-
Implantar em computadores
string.
Essa entrada só é válida para grupos de computadores e ainda não tem suporte para uma lista simples de computadores ou variáveis de saída.
Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 ou marcas, como Role:DB; OS:Win8.1. Se várias marcas forem fornecidas, a tarefa será executada em todos os computadores com as marcas especificadas. Para grupos de recursos do Azure, especifique o nome da máquina virtual, como ffweb, ffdb. O padrão executa a tarefa em todos os computadores.
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 e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Importante
Essa tarefa foi preterida. Use a implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico, versão clássica |
| Execuções em | Agent, DeploymentGroup |
| Demandas | Nenhum |
| Capacidades | Essa tarefa não atende a nenhuma demanda 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 | Implantar |