IISWebAppManagementOnMachineGroup@0: tarea de administración de la aplicación web de IIS v0

Artículo
2025-03-24

Use esta tarea para crear o actualizar sitios web, aplicaciones web, directorios virtuales o grupos de aplicaciones.

Sintaxis

# IIS web app manage v0
# Create or update websites, web apps, virtual directories, or application pools.
- task: IISWebAppManagementOnMachineGroup@0
  inputs:
    #EnableIIS: false # boolean. Enable IIS. Default: false.
    IISDeploymentType: 'IISWebsite' # 'IISWebsite' | 'IISWebApplication' | 'IISVirtualDirectory' | 'IISApplicationPool'. Required. Configuration type. Default: IISWebsite.
    ActionIISWebsite: 'CreateOrUpdateWebsite' # 'CreateOrUpdateWebsite' | 'StartWebsite' | 'StopWebsite'. Required when IISDeploymentType = IISWebsite. Action. Default: CreateOrUpdateWebsite.
    #ActionIISApplicationPool: 'CreateOrUpdateAppPool' # 'CreateOrUpdateAppPool' | 'StartAppPool' | 'StopAppPool' | 'RecycleAppPool'. Required when IISDeploymentType = IISApplicationPool. Action. Default: CreateOrUpdateAppPool.
    #StartStopWebsiteName: # string. Required when ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite. Website name. 
    #Protocol: 'http' # 'https' | 'http'. Required when IISDeploymentType = randomDeployment. Protocol. Default: http.
    #IPAddress: 'All Unassigned' # string. Required when IISDeploymentType = randomDeployment. IP address. Default: All Unassigned.
    #Port: '80' # string. Required when IISDeploymentType = randomDeployment. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when IISDeploymentType = randomDeployment. Server Name Indication required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name. 
    #HostNameWithHttp: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name. 
    #HostNameWithSNI: # string. Required when IISDeploymentType = randomDeployment. Host name. 
    #SSLCertThumbPrint: # string. Required when IISDeploymentType = randomDeployment. SSL certificate thumbprint. 
    #StartStopRecycleAppPoolName: # string. Required when ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool. Application pool name. 
  # IIS Website
    WebsiteName: # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Website name. 
    WebsitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    WebsitePhysicalPathAuth: 'WebsiteUserPassThrough' # 'WebsiteUserPassThrough' | 'WebsiteWindowsAuth'. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path authentication. Default: WebsiteUserPassThrough.
    #WebsiteAuthUserName: # string. Required when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Username. 
    #WebsiteAuthUserPassword: # string. Optional. Use when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Password. 
    #AddBinding: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Add binding. Default: false.
    #CreateOrUpdateAppPoolForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Create or update app pool. Default: false.
    #ConfigureAuthenticationForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Configure authentication. Default: false.
  # IIS Bindings
    #Bindings: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true. Add bindings. 
  # IIS Application pool
    #AppPoolNameForWebsite: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Name. 
    #DotNetVersionForWebsite: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. .NET version. Default: v4.0.
    #PipeLineModeForWebsite: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Managed pipeline mode. Default: Integrated.
    #AppPoolIdentityForWebsite: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsernameForWebsite: # string. Required when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Username. 
    #AppPoolPasswordForWebsite: # string. Optional. Use when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Password. 
  # IIS Authentication
    #AnonymousAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Anonymous authentication. Default: false.
    #BasicAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Basic authentication. Default: false.
    #WindowsAuthenticationForWebsite: true # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Windows authentication. Default: true.
  # IIS Virtual directory
    #ParentWebsiteNameForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Parent website name. 
    #VirtualPathForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Virtual path. 
    #PhysicalPathForVD: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISVirtualDirectory. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    #VDPhysicalPathAuth: 'VDUserPassThrough' # 'VDUserPassThrough' | 'VDWindowsAuth'. Optional. Use when IISDeploymentType = IISVirtualDirectory. Physical path authentication. Default: VDUserPassThrough.
    #VDAuthUserName: # string. Required when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Username. 
    #VDAuthUserPassword: # string. Optional. Use when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Password. 
  # IIS Application
    #ParentWebsiteNameForApplication: # string. Required when IISDeploymentType = IISWebApplication. Parent website name. 
    #VirtualPathForApplication: # string. Required when IISDeploymentType = IISWebApplication. Virtual path. 
    #PhysicalPathForApplication: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISWebApplication. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    #ApplicationPhysicalPathAuth: 'ApplicationUserPassThrough' # 'ApplicationUserPassThrough' | 'ApplicationWindowsAuth'. Optional. Use when IISDeploymentType = IISWebApplication. Physical path authentication. Default: ApplicationUserPassThrough.
    #ApplicationAuthUserName: # string. Required when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Username. 
    #ApplicationAuthUserPassword: # string. Optional. Use when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Password. 
    #CreateOrUpdateAppPoolForApplication: false # boolean. Optional. Use when IISDeploymentType = IISWebApplication. Create or update app pool. Default: false.
  # IIS Application pool
    #AppPoolNameForApplication: # string. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Name. 
    #DotNetVersionForApplication: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. .NET version. Default: v4.0.
    #PipeLineModeForApplication: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Managed pipeline mode. Default: Integrated.
    #AppPoolIdentityForApplication: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsernameForApplication: # string. Required when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Username. 
    #AppPoolPasswordForApplication: # string. Optional. Use when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Password. 
  # IIS Application pool
    AppPoolName: # string. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Name. 
    DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. .NET version. Default: v4.0.
    PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Managed pipeline mode. Default: Integrated.
    AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional appcmd.exe commands.

Entradas

EnableIIS - Habilitar de IIS
boolean. Valor predeterminado: false.

Establezca en true si desea instalar IIS en el equipo.

tipo de configuración de IISDeploymentType -
string. Obligatorio. Valores permitidos: IISWebsite (sitio web de IIS), IISWebApplication (aplicación web de IIS), IISVirtualDirectory (directorio virtual de IIS), IISApplicationPool (grupo de aplicaciones de IIS). Valor predeterminado: IISWebsite.

Especifica el tipo de configuración: sitio web, aplicación web, directorio virtual o grupo de aplicaciones.

ActionIISWebsite - acción
string. Obligatorio cuando IISDeploymentType = IISWebsite. Valores permitidos: CreateOrUpdateWebsite (Crear o actualizar), StartWebsite (Inicio), StopWebsite (Detener). Valor predeterminado: CreateOrUpdateWebsite.

Especifica la acción adecuada que desea realizar en un sitio web de IIS.

Crear o actualizar creará un sitio web o actualizará un sitio web existente.

Inicio, Detener se iniciará o detendrá el sitio web respectivamente.

ActionIISApplicationPool - acción
string. Obligatorio cuando IISDeploymentType = IISApplicationPool. Valores permitidos: CreateOrUpdateAppPool (Crear o actualizar), StartAppPool (Inicio), StopAppPool (Detener), RecycleAppPool (Reciclaje). Valor predeterminado: CreateOrUpdateAppPool.

Especifica la acción adecuada que desea realizar en un grupo de aplicaciones de IIS.

Crear o actualizar creará un grupo de aplicaciones o actualizará un grupo de aplicaciones existente.

Iniciar, Detener, Reciclar se iniciará, detendrá o reciclará el grupo de aplicaciones respectivamente.

nombre del sitio web de StartStopWebsiteName -
string. Obligatorio cuando ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite.

Especifica el nombre del sitio web de IIS.

nombre del sitio web de WebsiteName -
string. Obligatorio cuando ActionIISWebsite = CreateOrUpdateWebsite.

Especifica el nombre del sitio web de IIS que se va a crear o actualizar.

WebsitePhysicalPath - ruta de acceso física
string. Obligatorio cuando ActionIISWebsite = CreateOrUpdateWebsite. Valor predeterminado: %SystemDrive%\inetpub\wwwroot.

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

WebsitePhysicalPathAuth - de autenticación de ruta de acceso física
string. Obligatorio cuando ActionIISWebsite = CreateOrUpdateWebsite. Valores permitidos: WebsiteUserPassThrough (usuario de aplicación (paso a través), WebsiteWindowsAuth (autenticación de Windows). Valor predeterminado: WebsiteUserPassThrough.

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

de nombre de usuario de WebsiteAuthUserName -
string. Obligatorio cuando WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite.

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

de contraseña de WebsiteAuthUserPassword -
string. Opcional. Use cuando WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite.

Especifica la contraseña del usuario que se usará para acceder a la ruta de acceso física del sitio web.
El procedimiento recomendado es crear una variable en la canalización de compilación o versión, marcarla como Secret protegerla y, a continuación, proporcionarla al usar esta entrada, como $(userCredentials).
Nota: caracteres especiales de la contraseña se interpretan por argumentos de línea de comandos.

AddBinding - Agregar de enlace
boolean. Opcional. Use cuando ActionIISWebsite = CreateOrUpdateWebsite. Valor predeterminado: false.

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

de protocolo Protocol -
string. Obligatorio cuando IISDeploymentType = randomDeployment. 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 IISDeploymentType = randomDeployment. Valor predeterminado: All Unassigned.

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

Port - puerto
string. Obligatorio cuando IISDeploymentType = randomDeployment. Valor predeterminado: 80.

Especifica el puerto donde la pila de protocolos de transferencia de hipertexto (HTTP.sys) supervisará las solicitudes del sitio web.

Indicación de nombre del servidor ServerNameIndication - necesaria
boolean. Opcional. Use cuando IISDeploymentType = randomDeployment. Valor predeterminado: false.

Especifica la opción para establecer la indicación de nombre de servidor (SNI) para el sitio web.
SNI amplía los protocolos SSL y TLS para indicar el nombre de host al que los clientes intentan conectarse. Permite que varios sitios web seguros con certificados diferentes usen la misma dirección IP.

HostNameWithOutSNI - nombre de host
string. Opcional. Use cuando IISDeploymentType = randomDeployment.

Especifica un nombre de host (o nombre de dominio) para el sitio web.
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 IISDeploymentType = randomDeployment.

HostNameWithSNI - nombre de host
string. Obligatorio cuando IISDeploymentType = randomDeployment.

SSLCertThumbPrint - de huella digital del certificado SSL
string. Obligatorio cuando IISDeploymentType = randomDeployment.

Especifica la huella digital del certificado de capa de socket seguro que usa el sitio web para la comunicación HTTPS. La huella digital es una cadena hexadecimal de 40 caracteres. El certificado SSL ya debe estar instalado en el equipo en el almacén personal del equipo local.

Bindings - Agregar enlaces
string. Obligatorio cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true.

Especifica los enlaces para el sitio web.

Esta es una configuración de enlace de ejemplo en YAML:

Bindings: |
  {
      bindings:[
          {
              "protocol":"https",
              "ipAddress":"",
              "hostname":"my.hostname.com",
              "port":"443",
              "sslThumbprint":"",
              "sniFlag":true
          }
      ]
  }

CreateOrUpdateAppPoolForWebsite - creación o actualización del grupo de aplicaciones
boolean. Opcional. Use cuando ActionIISWebsite = CreateOrUpdateWebsite. Valor predeterminado: false.

Especifica la opción para crear o actualizar un grupo de aplicaciones. Si está activada, el sitio web se creará en el grupo de aplicaciones especificado.

ConfigureAuthenticationForWebsite - Configurar de autenticación
boolean. Opcional. Use cuando ActionIISWebsite = CreateOrUpdateWebsite. Valor predeterminado: false.

Especifica la opción para configurar la autenticación para el sitio web.

AppPoolNameForWebsite - nombre
string. Obligatorio cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Especifica el nombre del grupo de aplicaciones de IIS que se va a crear o actualizar.

DotNetVersionForWebsite - de la versión de .NET
string. Obligatorio cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Valores permitidos: v4.0, v2.0, No Managed Code. Valor predeterminado: v4.0.

Especifica la versión de .NET Framework que carga el 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.

PipeLineModeForWebsite - modo de canalización administrada
string. Obligatorio cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Valores permitidos: Integrated, Classic. Valor predeterminado: Integrated.

Especifica el modo de canalización administrada para determinar 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.

AppPoolIdentityForWebsite - Identity
string. Obligatorio cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Valores permitidos: ApplicationPoolIdentity (identidad del grupo de aplicaciones), LocalService (servicio local), LocalSystem (sistema local), NetworkService (servicio de red), SpecificUser (cuenta personalizada). Valor predeterminado: ApplicationPoolIdentity.

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

de nombre de usuario de AppPoolUsernameForWebsite -
string. Obligatorio cuando AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Especifica el nombre de usuario de la cuenta personalizada que desea usar.

de contraseña de AppPoolPasswordForWebsite -
string. Opcional. Use cuando AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Especifica la contraseña de la cuenta personalizada.
El procedimiento recomendado es crear una variable en la canalización de compilación o versión, marcarla como Secret protegerla y, a continuación, proporcionarla al usar esta entrada, como $(userCredentials).
Nota: caracteres especiales de la contraseña se interpretan por argumentos de línea de comandos.

AnonymousAuthenticationForWebsite - de autenticación anónima
boolean. Opcional. Use cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Valor predeterminado: false.

Especifica la opción para habilitar la autenticación anónima para un sitio web.

BasicAuthenticationForWebsite - autenticación básica
boolean. Opcional. Use cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Valor predeterminado: false.

Especifica la opción para habilitar la autenticación básica para un sitio web.

WindowsAuthenticationForWebsite - de autenticación de Windows
boolean. Opcional. Use cuando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Valor predeterminado: true.

Especifica la opción para habilitar la autenticación de Windows para un sitio web.

nombre del sitio web primario de ParentWebsiteNameForVD -
string. Obligatorio cuando IISDeploymentType = IISVirtualDirectory.

Especifica el nombre del sitio web primario del directorio virtual.

VirtualPathForVD - ruta de acceso virtual
string. Obligatorio cuando IISDeploymentType = IISVirtualDirectory.

Especifica la ruta de acceso virtual del directorio virtual.

Por ejemplo, para crear un directorio virtual Site/Application/VDir, escriba /Application/Vdir. El sitio web y la aplicación primarios ya deben existir.

PhysicalPathForVD - ruta de acceso física
string. Obligatorio cuando IISDeploymentType = IISVirtualDirectory. Valor predeterminado: %SystemDrive%\inetpub\wwwroot.

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

VDPhysicalPathAuth - de autenticación de ruta de acceso física
string. Opcional. Use cuando IISDeploymentType = IISVirtualDirectory. Valores permitidos: VDUserPassThrough (usuario de aplicación (paso a través), VDWindowsAuth (autenticación de Windows). Valor predeterminado: VDUserPassThrough.

Especifica el mecanismo de autenticación que se usa para acceder a la ruta de acceso física del directorio virtual.

de nombre de usuario de VDAuthUserName -
string. Obligatorio cuando VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory.

Especifica el nombre de usuario que se usa para acceder a la ruta de acceso física del directorio virtual.

de contraseña de VDAuthUserPassword -
string. Opcional. Use cuando VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory.

Especifica la contraseña del usuario que se usa para acceder a la ruta de acceso física del directorio virtual.
El procedimiento recomendado es crear una variable en la canalización de compilación o versión, marcarla como Secret protegerla y, a continuación, proporcionarla al usar esta entrada, como $(userCredentials).
Nota: caracteres especiales de la contraseña se interpretan por argumentos de línea de comandos.

nombre del sitio web primario de ParentWebsiteNameForApplication -
string. Obligatorio cuando IISDeploymentType = IISWebApplication.

Especifica el nombre del sitio web primario en el que se creará o actualizará la aplicación.

VirtualPathForApplication - ruta de acceso virtual
string. Obligatorio cuando IISDeploymentType = IISWebApplication.

Especifica la ruta de acceso virtual de la aplicación.

Por ejemplo, para crear una aplicación Site/Application, escriba /Application. El sitio web primario ya debe existir.

PhysicalPathForApplication - ruta de acceso física
string. Obligatorio cuando IISDeploymentType = IISWebApplication. Valor predeterminado: %SystemDrive%\inetpub\wwwroot.

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

ApplicationPhysicalPathAuth - de autenticación de ruta de acceso física
string. Opcional. Use cuando IISDeploymentType = IISWebApplication. Valores permitidos: ApplicationUserPassThrough (usuario de aplicación (paso a través), ApplicationWindowsAuth (autenticación de Windows). Valor predeterminado: ApplicationUserPassThrough.

Especifica el mecanismo de autenticación que se usa para acceder a la ruta de acceso física de la aplicación.

de nombre de usuario de ApplicationAuthUserName -
string. Obligatorio cuando ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication.

Especifica el nombre de usuario que se usa para acceder a la ruta de acceso física de la aplicación.

de contraseña de ApplicationAuthUserPassword -
string. Opcional. Use cuando ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication.

Especifica la contraseña del usuario que se usa para acceder a la ruta de acceso física de la aplicación.
El procedimiento recomendado es crear una variable en la canalización de compilación o versión, marcarla como Secret protegerla y, a continuación, proporcionarla al usar esta entrada, como $(userCredentials).
Nota: caracteres especiales de la contraseña se interpretan por argumentos de línea de comandos.

CreateOrUpdateAppPoolForApplication - creación o actualización del grupo de aplicaciones
boolean. Opcional. Use cuando IISDeploymentType = IISWebApplication. Valor predeterminado: false.

Especifica la opción para crear o actualizar un grupo de aplicaciones. Si está activada, la aplicación se creará en el grupo de aplicaciones especificado.

AppPoolNameForApplication - nombre
string. Obligatorio cuando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

Especifica el nombre del grupo de aplicaciones de IIS que se va a crear o actualizar.

DotNetVersionForApplication - de la versión de .NET
string. Obligatorio cuando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Valores permitidos: v4.0, v2.0, No Managed Code. Valor predeterminado: v4.0.

PipeLineModeForApplication - modo de canalización administrada
string. Obligatorio cuando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Valores permitidos: Integrated, Classic. Valor predeterminado: Integrated.

AppPoolIdentityForApplication - Identity
string. Obligatorio cuando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Valores permitidos: ApplicationPoolIdentity (identidad del grupo de aplicaciones), LocalService (servicio local), LocalSystem (sistema local), NetworkService (servicio de red), SpecificUser (cuenta personalizada). Valor predeterminado: ApplicationPoolIdentity.

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

de nombre de usuario de AppPoolUsernameForApplication -
string. Obligatorio cuando AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

Especifica el nombre de usuario de la cuenta personalizada que desea usar.

de contraseña de AppPoolPasswordForApplication -
string. Opcional. Use cuando AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

AppPoolName - nombre
string. Obligatorio cuando ActionIISApplicationPool = CreateOrUpdateAppPool.

Especifica el nombre del grupo de aplicaciones de IIS que se va a crear o actualizar.

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

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

AppPoolIdentity - Identity
string. Obligatorio cuando ActionIISApplicationPool = CreateOrUpdateAppPool. Valores permitidos: ApplicationPoolIdentity (identidad del grupo de aplicaciones), LocalService (servicio local), LocalSystem (sistema local), NetworkService (servicio de red), SpecificUser (cuenta personalizada). Valor predeterminado: ApplicationPoolIdentity.

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

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

Especifica el nombre de usuario de la cuenta personalizada que desea usar.

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

StartStopRecycleAppPoolName - nombre del grupo de aplicaciones
string. Obligatorio cuando ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool.

Especifica el nombre del grupo de aplicaciones de IIS.

AppCmdCommands - comandos de appcmd.exe adicionales
string.

Especifica comandos de AppCmd.exe adicionales. Para más de un comando, use un separador de línea.
Por ejemplo:
list apppools
list sites
recycle apppool /apppool.name:ExampleAppPoolName

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

Use esta tarea para crear o actualizar un sitio web, una aplicación web, un directorio virtual o un grupo de aplicaciones.

Requisitos

Requisito	Descripción
Tipos de canalización	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	2.111.0 o superior
Categoría de tarea	Desplegar

Compartir a través de

IISWebAppManagementOnMachineGroup@0: tarea de administración de la aplicación web de IIS v0

Sintaxis

Entradas

Opciones de control de tareas

Variables de salida

Observaciones

Requisitos

Comentarios

Recursos adicionales