IISWebAppDeployment@1: tarea implementación de aplicaciones web de IIS (en desuso) v1

Use esta tarea para implementar la aplicación web de IIS mediante MSDeploy y, a continuación, cree o actualice sitios web y grupos de aplicaciones.

Importante

Esta tarea está en desuso y se retirará el 31 de enero de 2024. Use implementación de aplicaciones web de IIS mediante WinRM- Viual Studio Marketplace.

Sintaxis

# 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

EnvironmentName - Machines
string. Obligatorio.

Especifica una lista separada por comas de direcciones IP de máquina o FQDN, junto con puertos. El puerto predeterminado se basa en el protocolo seleccionado, por ejemplo, dbserver.fabrikam.com o dbserver_int.fabrikam.com:5986,192.168.12.34:5986. También puede proporcionar la variable de salida de otras tareas, por ejemplo, $(variableName).

de inicio de sesión de administrador de AdminUserName -
string.

Especifica el inicio de sesión de administrador para las máquinas de destino.

de contraseña de AdminPassword -
string.

Especifica la contraseña de administrador de las máquinas de destino. Puede aceptar variables definidas en definiciones de compilación o versión, como $(passwordVariable). Puede marcar el tipo de variable como secret para protegerlo.

de protocolo WinRMProtocol -
string. Valores permitidos: Http, Https.

Especifica el protocolo usado para la conexión winRM con las máquinas. El valor predeterminado es HTTPS.

TestCertificate - de certificado de prueba
boolean. Opcional. Use cuando WinRMProtocol = Https. Valor predeterminado: true.

Selecciona la opción para omitir la validación de la autenticidad del certificado de la máquina por una entidad de certificación de confianza. El parámetro es necesario para el protocolo HTTPS winRM.

WebDeployPackage - web Deploy Package
string. Obligatorio.

Especifica la ubicación del archivo ZIP de Web Deploy (MSDeploy) en las máquinas de destino o en una ruta de acceso UNC como, \\BudgetIT\WebDeploy\WebDeployPackage.zip. La ruta de acceso UNC debe ser accesible para la cuenta de administrador de la máquina. También se admiten variables de entorno, como $env:windir, $env:systemrooty $env:windir\FabrikamFibre\Web.

WebDeployParamFile - archivo de parámetros de Web Deploy
string.

Especifica la ubicación del archivo de parámetros en las máquinas de destino o en una ruta de acceso UNC. El archivo de parámetros se usa para invalidar las opciones de configuración de la aplicación web, como el nombre de la aplicación web de IIS o la cadena de conexión de la base de datos.

OverRideParams - invalidar parámetros
string.

Los parámetros especificados aquí invalidarán los parámetros en el archivo ZIP MSDeploy y el archivo de parámetros. Para invalidar más de un parámetro, use un separador de línea.
Por ejemplo, "IIS Web Application Name"="Fabrikam" o "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - crear o actualizar el sitio web
boolean. Valor predeterminado: false.

Especifica la opción de crear un sitio web o actualizar un sitio web existente.

WebSiteName - nombre del sitio web
string. Obligatorio cuando CreateWebSite = true.

Especifica el nombre del sitio web de IIS que se creará si no existe o se actualizará si ya está presente en el servidor IIS. El nombre del sitio web debe ser el mismo que el especificado en el archivo de paquete ZIP de implementación web. Si también se especifica un archivo de parámetros e invalida la configuración de parámetros, el nombre del sitio web debe ser el mismo que en la configuración de parámetros de invalidación.

WebSitePhysicalPath - ruta de acceso física
string. Obligatorio cuando CreateWebSite = true. Valor predeterminado: %SystemDrive%\inetpub\wwwroot.

Especifica la ruta de acceso física donde se almacena el contenido del sitio web. El contenido puede residir en el equipo local o en un directorio o recurso compartido remoto, como C:\Fabrikam o \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - de autenticación de ruta de acceso física
string. Obligatorio cuando CreateWebSite = true. Valores permitidos: WebSiteUserPassThrough (usuario de aplicación (paso a través), WebSiteWindowsAuth (autenticación de Windows). Valor predeterminado: Application User (Pass-through).

Especifica el mecanismo de autenticación para acceder a la ruta de acceso física del sitio web.

WebSiteAuthUserName - de nombre de usuario
string. Obligatorio cuando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Especifica el nombre de usuario para acceder a la ruta de acceso física del sitio web.

de contraseña de WebSiteAuthUserPassword -
string. Opcional. Use cuando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Especifica la contraseña para acceder a la ruta de acceso física del sitio web. Si usa una gMSA, no es necesario.

AddBinding - agregar de enlace
boolean. Opcional. Use cuando CreateWebSite = true. Valor predeterminado: true.

Especifica la opción de agregar enlace de puerto para el sitio web.

AssignDuplicateBinding - asignar enlaces duplicados
boolean. Opcional. Use cuando AddBinding = true. Valor predeterminado: false.

Especifica la opción de agregar los enlaces especificados aquí (incluso si hay otro sitio web con los mismos enlaces). Si hay conflictos de enlace, solo se iniciará uno de los sitios web.

de protocolo Protocol -
string. Obligatorio cuando AddBinding = true. Valores permitidos: https, http. Valor predeterminado: http.

Especifica HTTP para que el sitio web tenga un enlace HTTP o HTTPS para que el sitio web tenga un enlace de Capa de sockets seguros (SSL).

IPAddress - dirección IP
string. Obligatorio cuando AddBinding = true. Valor predeterminado: All Unassigned.

Especifica una dirección IP que los usuarios pueden usar para acceder al sitio web. Si se selecciona todas las sin asignar, el sitio responderá a las solicitudes de todas las direcciones IP del puerto y el nombre de host opcional que se especifica para el sitio. El sitio no responderá a las solicitudes si otro sitio del servidor tiene un enlace en el mismo puerto, pero con una dirección IP específica.

Port - puerto
string. Obligatorio cuando AddBinding = true. Valor predeterminado: 80.

Especifica el puerto en el que la pila de protocolos de transferencia de hipertexto (HTTP.sys) debe supervisar las solicitudes realizadas a este sitio web.

Indicación de nombre de servidor ServerNameIndication - requerido
boolean. Opcional. Use cuando Protocol = https. Valor predeterminado: false.

Determina si el sitio web requiere indicación de nombre de servidor (SNI). SNI amplía los protocolos SSL y TLS para indicar a qué nombre de host está intentando conectarse el cliente. Permite que varios sitios web seguros con certificados diferentes usen la misma dirección IP.

de nombre de host de HostNameWithOutSNI -
string. Opcional. Use cuando ServerNameIndication = false.

Asigna uno o varios nombres de host (o nombres de dominio) a un equipo que usa una sola dirección IP. Si se especifica un nombre de host, los clientes deben usar el nombre de host en lugar de la dirección IP para acceder al sitio web.

de nombre de host de HostNameWithHttp -
string. Opcional. Use cuando Protocol = http.

Asigna uno o varios nombres de host (o nombres de dominio) a un equipo que usa una sola dirección IP. Si se especifica un nombre de host, los clientes deben usar el nombre de host en lugar de la dirección IP para acceder al sitio web.

de nombre de host de HostNameWithSNI -
string. Obligatorio cuando ServerNameIndication = true.

Asigna uno o varios nombres de host (o nombres de dominio) a un equipo que usa una sola dirección IP. Si se especifica un nombre de host, los clientes deben usar el nombre de host en lugar de la dirección IP para acceder al sitio web.

SSLCertThumbPrint - de impresión digital del certificado SSL
string. Obligatorio cuando Protocol = https.

Especifica la huella digital del certificado de capa de socket seguro que va a usar el sitio web. El certificado ya debe estar instalado en la máquina y estar presente en el almacén personal del equipo local.

CreateAppPool - crear o actualizar del grupo de aplicaciones
boolean. Valor predeterminado: false.

Especifica la opción de crear un grupo de aplicaciones o actualizar un grupo de aplicaciones existente.

AppPoolName - nombre
string. Obligatorio cuando CreateAppPool = true.

Especifica el nombre del grupo de aplicaciones de IIS que se va a crear o actualizar. El grupo de aplicaciones existente se actualizará con la configuración especificada.

DotNetVersion - versión de .NET
string. Obligatorio cuando CreateAppPool = true. Valores permitidos: v4.0, v2.0, No Managed Code. Valor predeterminado: v4.0.

Especifica la versión de .NET Framework que carga este grupo de aplicaciones. Si las aplicaciones asignadas a este grupo de aplicaciones no contienen código administrado, seleccione la opción Sin código administrado de la lista.

modo de canalización administrada de PipeLineMode -
string. Obligatorio cuando CreateAppPool = true. Valores permitidos: Integrated, Classic. Valor predeterminado: Integrated.

El modo de canalización administrada especifica cómo IIS procesa las solicitudes de contenido administrado. Use el modo clásico solo cuando las aplicaciones del grupo de aplicaciones no se puedan ejecutar en modo integrado.

AppPoolIdentity - Identity
string. Obligatorio cuando CreateAppPool = true. Valores permitidos: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (cuenta personalizada). Valor predeterminado: ApplicationPoolIdentity.

Configura la cuenta en la que se ejecuta el proceso de trabajo de un grupo de aplicaciones. Especifique una de las cuentas de seguridad predefinidas o configure una cuenta personalizada.

de nombre de usuario de AppPoolUsername -
string. Obligatorio cuando AppPoolIdentity = SpecificUser.

de contraseña de AppPoolPassword -
string. Opcional. Use cuando AppPoolIdentity = SpecificUser.

Si usa una gMSA, no es necesario.

AppCmdCommands - comandos de AppCmd.exe adicionales
string.

Especifica comandos de AppCmd.exe adicionales para establecer las propiedades del sitio web o del grupo de aplicaciones. Para más de un comando, use un separador de línea.
Por ejemplo:
<lista de grupos de aplicaciones>
<lista de sitios>

DeployInParallel - Implementación en en paralelo
boolean. Valor predeterminado: true.

Si se establece en true, la aplicación web se implementa en paralelo en las máquinas de destino.

ResourceFilteringMethod - Seleccionar máquinas por
string. Valores permitidos: machineNames (nombres de máquina), tags. Valor predeterminado: machineNames.

Opcional. Especifica un subconjunto de máquinas proporcionando nombres de máquina o etiquetas.

MachineFilter - implementar en máquinas
string.

Esta entrada solo es válida para grupos de máquinas y aún no se admite para una lista plana de máquinas o variables de salida.

Especifica una lista de máquinas, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 o etiquetas, como Role:DB; OS:Win8.1. Si se proporcionan varias etiquetas, la tarea se ejecutará en todas las máquinas con las etiquetas especificadas. En Grupos de recursos de Azure, especifique el nombre de la máquina virtual, como ffweb, ffdb. El valor predeterminado ejecuta la tarea en todas las máquinas.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Importante

Esta tarea está en desuso. Use implementación de aplicaciones web de IIS mediante WinRM- Viual Studio Marketplace.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.91.0 o superior
Categoría de tarea	Desplegar