IISWebAppDeployment@1: tarea de implementación de aplicaciones web de IIS (en desuso) v1
Use esta tarea para implementar IIS Web App 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 la implementación de aplicaciones web de IIS mediante WinRM - Viual Studio Marketplace.
Use esta tarea para implementar IIS Web App mediante MSDeploy y, a continuación, cree o actualice sitios web y grupos de aplicaciones.
Importante
Esta tarea está en desuso. Use la implementación de aplicaciones web de IIS mediante WinRM - Viual Studio Marketplace.
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
-
Máquinas
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)
.
AdminUserName
-
Inicio de sesión del administrador
string
.
Especifica el inicio de sesión de administrador para las máquinas de destino.
AdminPassword
-
Contraseña
string
.
Especifica la contraseña de administrador para 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.
WinRMProtocol
-
Protocolo
string
. Valores permitidos: Http
, Https
.
Especifica el protocolo utilizado para la conexión de WinRM con las máquinas. El valor predeterminado es HTTPS
.
TestCertificate
-
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 mediante una entidad de certificación de confianza. El parámetro es necesario para el protocolo WinRM HTTPS
.
WebDeployPackage
-
Paquete de implementación web
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:systemroot
y $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 el cadena de conexión de base de datos.
OverRideParams
-
Invalidar parámetros
string
.
Los parámetros especificados aquí invalidarán los parámetros del 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 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
. Necesario 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 y una configuración de parámetros de invalidación, 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
. Necesario 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
-
Autenticación de ruta de acceso física
string
. Necesario 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
-
Nombre de usuario
string
. Necesario cuando WebSitePhysicalPathAuth = WebSiteWindowsAuth
.
Especifica el nombre de usuario para acceder a la ruta de acceso física del sitio web.
WebSiteAuthUserPassword
-
Contraseña
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 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 enlace duplicado
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.
Protocol
-
Protocolo
string
. Necesario 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
. Necesario 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 Todo sin asignar , el sitio responderá a las solicitudes de todas las direcciones IP del puerto y el nombre de host opcional especificado 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
. Necesario 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.
ServerNameIndication
-
Indicación de nombre de servidor requerida
boolean
. Opcional. Use cuando Protocol = https
. Valor predeterminado: false
.
Determina si el sitio web requiere Indicación de nombre de servidor (SNI). SNI extiende 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.
HostNameWithOutSNI
-
Nombre de host
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.
HostNameWithHttp
-
Nombre de host
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.
HostNameWithSNI
-
Nombre de host
string
. Necesario 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
-
Huella digital del certificado SSL
string
. Necesario cuando Protocol = https
.
Especifica la huella digital del certificado de capa de sockets seguros que va a usar el sitio web. El certificado ya debe estar instalado en el equipo y presente en el almacén Personal del equipo local.
CreateAppPool
-
Crear o actualizar el 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
. Necesario 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
. Necesario cuando CreateAppPool = true
. Valores permitidos: v4.0
, v2.0
y 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.
PipeLineMode
-
Modo de canalización administrada
string
. Necesario 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
-
Identidad
string
. Necesario 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.
AppPoolUsername
-
Nombre de usuario
string
. Necesario cuando AppPoolIdentity = SpecificUser
.
AppPoolPassword
-
Contraseña
string
. Opcional. Use cuando AppPoolIdentity = SpecificUser
.
Si usa una gMSA, esto no es necesario.
AppCmdCommands
-
Comandos de AppCmd.exe adicionales
string
.
Especifica comandos adicionales AppCmd.exe
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:
<enumerar grupos de aplicaciones>
<list sites>
DeployInParallel
-
Implementación en paralelo
boolean
. Valor predeterminado: true
.
Si se establece true
en , 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
-
Implementación 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 las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Comentarios
Importante
Esta tarea está en desuso. Use la 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 |
Peticiones | None |
Capabilities | Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
Restricciones de comandos | Any |
Variables que se pueden establecer | Any |
Versión del agente | 1.91.0 o superior |
Categoría de la tarea: | Implementación |