IISWebAppManagementOnMachineGroup@0 – Tarefa gerenciar aplicativo Web do IIS v0
Use essa tarefa para criar ou atualizar sites, aplicativos Web, diretórios virtuais ou pools de aplicativos.
Sintaxe
# 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 do IIS
boolean
. Valor padrão: false
.
Defina como true
se você quiser instalar o IIS no computador.
IISDeploymentType
-
tipo de configuração
string
. Obrigatório Valores permitidos: IISWebsite
(Site do IIS), IISWebApplication
(Aplicativo Web do IIS), IISVirtualDirectory
(Diretório Virtual do IIS), IISApplicationPool
(Pool de Aplicativos do IIS). Valor padrão: IISWebsite
.
Especifica o tipo de configuração: site, aplicativo Web, diretório virtual ou pool de aplicativos.
de Ação ActionIISWebsite
-
string
. Necessário quando IISDeploymentType = IISWebsite
. Valores permitidos: CreateOrUpdateWebsite
(Criar ou Atualizar), StartWebsite
(Iniciar), StopWebsite
(Parar). Valor padrão: CreateOrUpdateWebsite
.
Especifica a ação apropriada que você deseja executar em um site do IIS.
Criar ou Atualizar criará um site ou atualizará um site existente.
Iniciar, Parar iniciará ou interromperá o site, respectivamente.
de Ação ActionIISApplicationPool
-
string
. Necessário quando IISDeploymentType = IISApplicationPool
. Valores permitidos: CreateOrUpdateAppPool
(Criar ou Atualizar), StartAppPool
(Iniciar), StopAppPool
(Parar), RecycleAppPool
(Reciclar). Valor padrão: CreateOrUpdateAppPool
.
Especifica a ação apropriada que você deseja executar em um pool de aplicativos do IIS.
Criar ou Atualizar criará um pool de aplicativos ou atualizará um pool de aplicativos existente.
Iniciar, Parar, Reciclar iniciará, interromperá ou reciclará o pool de aplicativos, respectivamente.
StartStopWebsiteName
-
nome do site
string
. Necessário quando ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite
.
Especifica o nome do site do IIS.
WebsiteName
-
nome do site
string
. Necessário quando ActionIISWebsite = CreateOrUpdateWebsite
.
Especifica o nome do site do IIS a ser criado ou atualizado.
WebsitePhysicalPath
-
caminho físico
string
. Necessário quando ActionIISWebsite = CreateOrUpdateWebsite
. Valor padrão: %SystemDrive%\inetpub\wwwroot
.
Especifica o caminho físico em que o conteúdo do site será armazenado. O conteúdo pode residir no computador local, em um diretório remoto ou em um compartilhamento de rede, como C:\Fabrikam
ou \\ContentShare\Fabrikam
.
WebsitePhysicalPathAuth
-
de autenticação de caminho físico
string
. Necessário quando ActionIISWebsite = CreateOrUpdateWebsite
. Valores permitidos: WebsiteUserPassThrough
(Usuário do Aplicativo (Passagem)), WebsiteWindowsAuth
(Autenticação do Windows). Valor padrão: WebsiteUserPassThrough
.
Especifica o mecanismo de autenticação que será usado para acessar o caminho físico do site.
WebsiteAuthUserName
-
de nome de usuário
string
. Necessário quando WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite
.
Especifica o nome de usuário que será usado para acessar o caminho físico do site.
WebsiteAuthUserPassword
-
de senha
string
. Opcional. Use quando WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite
.
Especifica a senha do usuário que será usada para acessar o caminho físico do site.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
AddBinding
-
Adicionar de associação
boolean
. Opcional. Use quando ActionIISWebsite = CreateOrUpdateWebsite
. Valor padrão: false
.
Especifica a opção de adicionar associação de porta para o site.
de Protocolo Protocol
-
string
. Necessário quando IISDeploymentType = randomDeployment
. 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 IISDeploymentType = randomDeployment
. Valor padrão: All Unassigned
.
Especifica um endereço IP que os usuários finais podem usar para acessar este site.
Se Todos os não atribuídos estiverem selecionados, o site responderá às solicitações de todos os endereços IP na porta e para o nome do host. 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 IISDeploymentType = randomDeployment
. Valor padrão: 80
.
Especifica a porta em que a Pilha de Protocolos de Transferência de Hipertexto (HTTP.sys) monitorará as solicitações do site.
Indicação de nome do servidor ServerNameIndication
- necessária
boolean
. Opcional. Use quando IISDeploymentType = randomDeployment
. Valor padrão: false
.
Especifica a opção para definir a SNI (Indicação de Nome do Servidor) para o site.
O SNI estende os protocolos SSL e TLS para indicar o nome do host ao qual os clientes estão 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 IISDeploymentType = randomDeployment
.
Especifica um nome de host (ou nome de domínio) para o site.
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 IISDeploymentType = randomDeployment
.
Especifica um nome de host (ou nome de domínio) para o site.
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 IISDeploymentType = randomDeployment
.
Especifica um nome de host (ou nome de domínio) para o site.
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 IISDeploymentType = randomDeployment
.
Especifica a impressão digital do certificado Secure Socket Layer que o site usa para a comunicação HTTPS. A impressão digital é uma cadeia de caracteres hexadecimal de 40 caracteres. O certificado SSL já deve estar instalado no computador no repositório Pessoal do Computador Local.
Bindings
-
Adicionar associações
string
. Necessário quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true
.
Especifica as associações para o site.
Aqui está uma configuração de associação de exemplo no YAML:
Bindings: |
{
bindings:[
{
"protocol":"https",
"ipAddress":"",
"hostname":"my.hostname.com",
"port":"443",
"sslThumbprint":"",
"sniFlag":true
}
]
}
CreateOrUpdateAppPoolForWebsite
-
Criar ou atualizar o pool de aplicativos
boolean
. Opcional. Use quando ActionIISWebsite = CreateOrUpdateWebsite
. Valor padrão: false
.
Especifica a opção de criar ou atualizar um pool de aplicativos. Se marcada, o site será criado no pool de aplicativos especificado.
ConfigureAuthenticationForWebsite
-
Configurar de autenticação
boolean
. Opcional. Use quando ActionIISWebsite = CreateOrUpdateWebsite
. Valor padrão: false
.
Especifica a opção de configurar a autenticação para o site.
AppPoolNameForWebsite
-
Name
string
. Necessário quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
.
Especifica o nome do pool de aplicativos do IIS a ser criado ou atualizado.
DotNetVersionForWebsite
-
versão do .NET
string
. Necessário quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
. Valores permitidos: v4.0
, v2.0
, No Managed Code
. Valor padrão: v4.0
.
Especifica a versão do .NET Framework que é carregada pelo 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.
PipeLineModeForWebsite
-
modo de pipeline gerenciado
string
. Necessário quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
. Valores permitidos: Integrated
, Classic
. Valor padrão: Integrated
.
Especifica o modo de pipeline gerenciado para determinar 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.
de identidade do AppPoolIdentityForWebsite
-
string
. Necessário quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
. Valores permitidos: ApplicationPoolIdentity
(Identidade do Pool de Aplicativos), LocalService
(Serviço Local), LocalSystem
(Sistema Local), NetworkService
(Serviço de Rede), SpecificUser
(Conta Personalizada). Valor padrão: ApplicationPoolIdentity
.
Configura a conta na qual o processo de trabalho de um pool de aplicativos é executado. Especifica uma das contas de segurança predefinidas ou configura uma conta personalizada.
AppPoolUsernameForWebsite
-
de nome de usuário
string
. Necessário quando AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
.
Especifica o nome de usuário da conta personalizada que você deseja usar.
AppPoolPasswordForWebsite
-
de senha
string
. Opcional. Use quando AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true
.
Especifica a senha da conta personalizada.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
AnonymousAuthenticationForWebsite
-
de autenticação anônima
boolean
. Opcional. Use quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
. Valor padrão: false
.
Especifica a opção de habilitar a autenticação anônima para um site.
BasicAuthenticationForWebsite
-
de autenticação básica
boolean
. Opcional. Use quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
. Valor padrão: false
.
Especifica a opção de habilitar a autenticação básica para um site.
WindowsAuthenticationForWebsite
-
de autenticação do Windows
boolean
. Opcional. Use quando IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true
. Valor padrão: true
.
Especifica a opção de habilitar a autenticação do Windows para um site.
ParentWebsiteNameForVD
-
nome do site pai
string
. Necessário quando IISDeploymentType = IISVirtualDirectory
.
Especifica o nome do site pai do diretório virtual.
VirtualPathForVD
-
caminho virtual
string
. Necessário quando IISDeploymentType = IISVirtualDirectory
.
Especifica o caminho virtual do diretório virtual.
Por exemplo, para criar um diretório virtual Site/Application/VDir
, insira /Application/Vdir
. O site pai e o aplicativo já devem existir.
PhysicalPathForVD
-
caminho físico
string
. Necessário quando IISDeploymentType = IISVirtualDirectory
. Valor padrão: %SystemDrive%\inetpub\wwwroot
.
Especifica o caminho físico em que o conteúdo do diretório virtual é armazenado. O conteúdo pode residir no computador local, em um diretório remoto ou em um compartilhamento de rede, como C:\Fabrikam
ou \\ContentShare\Fabrikam
.
VDPhysicalPathAuth
-
de autenticação de caminho físico
string
. Opcional. Use quando IISDeploymentType = IISVirtualDirectory
. Valores permitidos: VDUserPassThrough
(Usuário do Aplicativo (Passagem)), VDWindowsAuth
(Autenticação do Windows). Valor padrão: VDUserPassThrough
.
Especifica o mecanismo de autenticação usado para acessar o caminho físico do diretório virtual.
VDAuthUserName
-
de nome de usuário
string
. Necessário quando VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory
.
Especifica o nome de usuário usado para acessar o caminho físico do diretório virtual.
VDAuthUserPassword
-
de senha
string
. Opcional. Use quando VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory
.
Especifica a senha do usuário usada para acessar o caminho físico do diretório virtual.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
ParentWebsiteNameForApplication
-
nome do site pai
string
. Necessário quando IISDeploymentType = IISWebApplication
.
Especifica o nome do site pai no qual o aplicativo será criado ou atualizado.
VirtualPathForApplication
-
caminho virtual
string
. Necessário quando IISDeploymentType = IISWebApplication
.
Especifica o caminho virtual do aplicativo.
Por exemplo, para criar um aplicativo Site/Application
, insira /Application
. O site pai já deve existir.
PhysicalPathForApplication
-
caminho físico
string
. Necessário quando IISDeploymentType = IISWebApplication
. Valor padrão: %SystemDrive%\inetpub\wwwroot
.
Especifica o caminho físico em que o conteúdo do aplicativo é armazenado. O conteúdo pode residir no computador local, em um diretório remoto ou em um compartilhamento de rede, como C:\Fabrikam
ou \\ContentShare\Fabrikam
.
ApplicationPhysicalPathAuth
-
de autenticação de caminho físico
string
. Opcional. Use quando IISDeploymentType = IISWebApplication
. Valores permitidos: ApplicationUserPassThrough
(Usuário do Aplicativo (Passagem)), ApplicationWindowsAuth
(Autenticação do Windows). Valor padrão: ApplicationUserPassThrough
.
Especifica o mecanismo de autenticação usado para acessar o caminho físico do aplicativo.
ApplicationAuthUserName
-
de nome de usuário
string
. Necessário quando ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication
.
Especifica o nome de usuário usado para acessar o caminho físico do aplicativo.
ApplicationAuthUserPassword
-
de senha
string
. Opcional. Use quando ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication
.
Especifica a senha do usuário usada para acessar o caminho físico do aplicativo.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
CreateOrUpdateAppPoolForApplication
-
Criar ou atualizar o pool de aplicativos
boolean
. Opcional. Use quando IISDeploymentType = IISWebApplication
. Valor padrão: false
.
Especifica a opção de criar ou atualizar um pool de aplicativos. Se marcada, o aplicativo será criado no pool de aplicativos especificado.
AppPoolNameForApplication
-
Name
string
. Necessário quando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
.
Especifica o nome do pool de aplicativos do IIS a ser criado ou atualizado.
DotNetVersionForApplication
-
versão do .NET
string
. Necessário quando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
. Valores permitidos: v4.0
, v2.0
, No Managed Code
. Valor padrão: v4.0
.
Especifica a versão do .NET Framework que é carregada pelo 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.
PipeLineModeForApplication
-
modo de pipeline gerenciado
string
. Necessário quando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
. Valores permitidos: Integrated
, Classic
. Valor padrão: Integrated
.
Especifica o modo de pipeline gerenciado para determinar 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.
de identidade do AppPoolIdentityForApplication
-
string
. Necessário quando IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
. Valores permitidos: ApplicationPoolIdentity
(Identidade do Pool de Aplicativos), LocalService
(Serviço Local), LocalSystem
(Sistema Local), NetworkService
(Serviço de Rede), SpecificUser
(Conta Personalizada). Valor padrão: ApplicationPoolIdentity
.
Configura a conta na qual o processo de trabalho de um pool de aplicativos é executado. Especifica uma das contas de segurança predefinidas ou configura uma conta personalizada.
AppPoolUsernameForApplication
-
de nome de usuário
string
. Necessário quando AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
.
Especifica o nome de usuário da conta personalizada que você deseja usar.
AppPoolPasswordForApplication
-
de senha
string
. Opcional. Use quando AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true
.
Especifica a senha da conta personalizada.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
AppPoolName
-
Name
string
. Necessário quando ActionIISApplicationPool = CreateOrUpdateAppPool
.
Especifica o nome do pool de aplicativos do IIS a ser criado ou atualizado.
DotNetVersion
-
versão do .NET
string
. Necessário quando ActionIISApplicationPool = CreateOrUpdateAppPool
. Valores permitidos: v4.0
, v2.0
, No Managed Code
. Valor padrão: v4.0
.
Especifica a versão do .NET Framework que é carregada pelo 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 ActionIISApplicationPool = CreateOrUpdateAppPool
. Valores permitidos: Integrated
, Classic
. Valor padrão: Integrated
.
Especifica o modo de pipeline gerenciado para determinar 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.
de identidade do AppPoolIdentity
-
string
. Necessário quando ActionIISApplicationPool = CreateOrUpdateAppPool
. Valores permitidos: ApplicationPoolIdentity
(Identidade do Pool de Aplicativos), LocalService
(Serviço Local), LocalSystem
(Sistema Local), NetworkService
(Serviço de Rede), SpecificUser
(Conta Personalizada). Valor padrão: ApplicationPoolIdentity
.
Configura a conta na qual o processo de trabalho de um pool de aplicativos é executado. Especifica uma das contas de segurança predefinidas ou configura uma conta personalizada.
AppPoolUsername
-
de nome de usuário
string
. Necessário quando AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool
.
Especifica o nome de usuário da conta personalizada que você deseja usar.
AppPoolPassword
-
de senha
string
. Opcional. Use quando AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool
.
Especifica a senha da conta personalizada.
A melhor prática é criar uma variável no pipeline de build ou lançamento, marcá-la como Secret
para protegê-la e, em seguida, fornecê-la ao usar essa entrada, como $(userCredentials)
.
Observação: caracteres especiais na senha são interpretados por argumentos de linha de comando.
StartStopRecycleAppPoolName
-
nome do pool de aplicativos
string
. Necessário quando ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool
.
Especifica o nome do pool de aplicativos do IIS.
comandos de appcmd.exe adicionais AppCmdCommands
-
string
.
Especifica comandos de AppCmd.exe
adicionais. Para mais de um comando, use um separador de linha.
Por exemplo:
list apppools
list sites
recycle apppool /apppool.name:ExampleAppPoolName
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 de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Use essa tarefa para criar ou atualizar um site, aplicativo Web, diretório virtual ou pool de aplicativos.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | Versão clássica |
Execuções em | Agent, DeploymentGroup |
de demandas | Nenhum |
recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
restrições de comando | Qualquer |
variáveis settable | Qualquer |
Versão do agente | 2.111.0 ou superior |
Categoria de tarefa | Implantar |