IISWebAppDeployment@1 - Attività Distribuzione app Web IIS (deprecata) v1

Usare questa attività per distribuire l'app Web IIS usando MSDeploy, quindi creare o aggiornare siti Web e pool di app.

Importante

Questa attività è deprecata e verrà ritirata il 31 gennaio 2024. Usare la distribuzione di app Web IIS con WinRM - Viual Studio Marketplace.

Sintassi

# 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.

Input

EnvironmentName - Macchine
string. Obbligatorio.

Specifica un elenco delimitato da virgole di indirizzi IP o FQDN del computer, insieme alle porte. La porta predefinita è basata sul protocollo selezionato, ad esempio dbserver.fabrikam.com o dbserver_int.fabrikam.com:5986,192.168.12.34:5986. È anche possibile specificare la variabile di output di altre attività, ad esempio $(variableName).

AdminUserName - account di accesso Amministrazione
string.

Specifica l'account di accesso amministratore per i computer di destinazione.

AdminPassword - Password
string.

Specifica la password di amministratore per i computer di destinazione. Può accettare variabili definite nelle definizioni di compilazione/versione, ad esempio $(passwordVariable). È possibile contrassegnare il tipo di variabile per secret proteggerlo.

WinRMProtocol - Protocollo
string. Valori consentiti: Http, Https.

Specifica il protocollo usato per la connessione WinRM con i computer. Il valore predefinito è HTTPS.

TestCertificate - Testare il certificato
boolean. facoltativo. Usare quando WinRMProtocol = Https. Valore predefinito: true.

Seleziona l'opzione per ignorare la convalida dell'autenticità del certificato del computer da parte di un'autorità di certificazione attendibile. Il parametro è obbligatorio per il protocollo WinRM HTTPS .

WebDeployPackage - Pacchetto di distribuzione Web
string. Obbligatorio.

Specifica il percorso del file ZIP Distribuzione Web (MSDeploy) nei computer di destinazione o in un percorso UNC, ad esempio . \\BudgetIT\WebDeploy\WebDeployPackage.zip Il percorso UNC deve essere accessibile all'account amministratore del computer. Le variabili di ambiente sono supportate anche, ad esempio $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.

WebDeployParamFile - File di parametri distribuzione Web
string.

Specifica il percorso del file di parametri nei computer di destinazione o in un percorso UNC. Il file di parametri viene usato per eseguire l'override delle impostazioni di configurazione dell'applicazione Web, ad esempio il nome dell'applicazione Web IIS o il database stringa di connessione.

OverRideParams - Eseguire l'override dei parametri
string.

I parametri specificati qui eseguiranno l'override dei parametri nel file ZIP MSDeploy e nel file di parametri. Per eseguire l'override di più di un parametro, usare un separatore di riga.
Ad esempio, "IIS Web Application Name"="Fabrikam" o "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Creare o aggiornare un sito Web
boolean. Valore predefinito: false.

Specifica l'opzione per creare un sito Web o per aggiornare un sito Web esistente.

WebSiteName - Nome sito Web
string. Obbligatorio quando CreateWebSite = true.

Specifica il nome del sito Web IIS che verrà creato se non esiste o verrà aggiornato se è già presente nel server IIS. Il nome del sito Web deve corrispondere a quello specificato nel file del pacchetto ZIP di distribuzione Web. Se viene specificata anche un'impostazione di parametri e parametri di override, il nome del sito Web deve essere uguale a quello nell'impostazione dei parametri di override.

WebSitePhysicalPath - Percorso fisico
string. Obbligatorio quando CreateWebSite = true. Valore predefinito: %SystemDrive%\inetpub\wwwroot.

Specifica il percorso fisico in cui è archiviato il contenuto del sito Web. Il contenuto può risiedere nel computer locale o in una directory remota o in una condivisione, ad esempio C:\Fabrikam o \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Autenticazione del percorso fisico
string. Obbligatorio quando CreateWebSite = true. Valori consentiti: WebSiteUserPassThrough (Utente applicazione (pass-through)), WebSiteWindowsAuth (autenticazione di Windows). Valore predefinito: Application User (Pass-through).

Specifica il meccanismo di autenticazione per l'accesso al percorso fisico del sito Web.

WebSiteAuthUserName - Nome utente
string. Obbligatorio quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Specifica il nome utente per l'accesso al percorso fisico del sito Web.

WebSiteAuthUserPassword - Password
string. facoltativo. Usare quando WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Specifica la password per l'accesso al percorso fisico del sito Web. Se si usa un account del servizio gestito del gruppo, non è necessario.

AddBinding - Aggiungi binding
boolean. facoltativo. Usare quando CreateWebSite = true. Valore predefinito: true.

Specifica l'opzione per aggiungere l'associazione di porte per il sito Web.

AssignDuplicateBinding - Assegnare binding duplicato
boolean. facoltativo. Usare quando AddBinding = true. Valore predefinito: false.

Specifica l'opzione per aggiungere le associazioni specificate qui (anche se è presente un altro sito Web con le stesse associazioni). Se sono presenti conflitti di associazione, verrà avviato solo uno dei siti Web.

Protocol - Protocollo
string. Obbligatorio quando AddBinding = true. Valori consentiti: https, http. Valore predefinito: http.

Specifica http per il sito Web per avere un'associazione HTTP o HTTPS per il sito Web in modo che disponga di un'associazione Secure Sockets Layer (SSL).

IPAddress - Indirizzo IP
string. Obbligatorio quando AddBinding = true. Valore predefinito: All Unassigned.

Specifica un indirizzo IP che gli utenti possono usare per accedere al sito Web. Se è selezionata l'opzione Tutti gli elementi non assegnati , il sito risponderà alle richieste per tutti gli indirizzi IP nella porta e al nome host facoltativo specificato per il sito. Il sito non risponderà alle richieste se un altro sito nel server dispone di un'associazione sulla stessa porta, ma con un indirizzo IP specifico.

Port - Porta
string. Obbligatorio quando AddBinding = true. Valore predefinito: 80.

Specifica la porta su cui deve essere monitorato hypertext Transfer Protocol Stack (HTTP.sys) per le richieste effettuate al sito Web.

ServerNameIndication - Indicazione del nome del server obbligatoria
boolean. facoltativo. Usare quando Protocol = https. Valore predefinito: false.

Determina se il sito Web richiede l'indicazione nome server (SNI, Server Name Indication). SNI estende i protocolli SSL e TLS per indicare il nome host a cui il client sta tentando di connettersi. Consente a più siti Web sicuri con certificati diversi di usare lo stesso indirizzo IP.

HostNameWithOutSNI - Nome host
string. facoltativo. Usare quando ServerNameIndication = false.

Assegna uno o più nomi host (o nomi di dominio) a un computer che usa un singolo indirizzo IP. Se viene specificato un nome host, i client devono usare il nome host anziché l'indirizzo IP per accedere al sito Web.

HostNameWithHttp - Nome host
string. facoltativo. Usare quando Protocol = http.

Assegna uno o più nomi host (o nomi di dominio) a un computer che usa un singolo indirizzo IP. Se viene specificato un nome host, i client devono usare il nome host anziché l'indirizzo IP per accedere al sito Web.

HostNameWithSNI - Nome host
string. Obbligatorio quando ServerNameIndication = true.

Assegna uno o più nomi host (o nomi di dominio) a un computer che usa un singolo indirizzo IP. Se viene specificato un nome host, i client devono usare il nome host anziché l'indirizzo IP per accedere al sito Web.

SSLCertThumbPrint - Stampa personale del certificato SSL
string. Obbligatorio quando Protocol = https.

Specifica la stampa personale del certificato Secure Socket Layer che verrà usato dal sito Web. Il certificato deve essere già installato nel computer e presente nell'archivio personale del computer locale.

CreateAppPool - Creare o aggiornare il pool di applicazioni
boolean. Valore predefinito: false.

Specifica l'opzione per creare un pool di applicazioni o per aggiornare un pool di applicazioni esistente.

AppPoolName - Nome
string. Obbligatorio quando CreateAppPool = true.

Specifica il nome del pool di applicazioni IIS da creare o aggiornare. Il pool di applicazioni esistente verrà aggiornato con le impostazioni specificate.

DotNetVersion - Versione di .NET
string. Obbligatorio quando CreateAppPool = true. Valori consentiti: v4.0, v2.0, No Managed Code. Valore predefinito: v4.0.

Specifica la versione di .NET Framework caricata da questo pool di applicazioni. Se le applicazioni assegnate a questo pool di applicazioni non contengono codice gestito, selezionare l'opzione Nessun codice gestito nell'elenco.

PipeLineMode - Modalità pipeline gestita
string. Obbligatorio quando CreateAppPool = true. Valori consentiti: Integrated, Classic. Valore predefinito: Integrated.

La modalità pipeline gestita specifica il modo in cui IIS elabora le richieste per il contenuto gestito. Usare la modalità classica solo quando le applicazioni nel pool di applicazioni non possono essere eseguite in modalità integrata.

AppPoolIdentity - Identità
string. Obbligatorio quando CreateAppPool = true. Valori consentiti: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (account personalizzato). Valore predefinito: ApplicationPoolIdentity.

Configura l'account in cui viene eseguito il processo di lavoro di un pool di applicazioni. Specificare uno degli account di sicurezza predefiniti o configurare un account personalizzato.

AppPoolUsername - Nome utente
string. Obbligatorio quando AppPoolIdentity = SpecificUser.

AppPoolPassword - Password
string. facoltativo. Usare quando AppPoolIdentity = SpecificUser.

Se si usa un account del servizio gestito del gruppo, non è necessario.

AppCmdCommands - Comandi aggiuntivi AppCmd.exe
string.

Specifica comandi aggiuntivi AppCmd.exe per impostare le proprietà del sito Web o del pool di applicazioni. Per più di un comando, usare un separatore di riga.
Ad esempio:
<elencare i pool di app>
<elencare i siti>

DeployInParallel - Distribuire in parallelo
boolean. Valore predefinito: true.

Se impostato su true, l'applicazione Web viene distribuita in parallelo nei computer di destinazione.

ResourceFilteringMethod - Selezionare Computer per
string. Valori consentiti: machineNames (Nomi computer), tags. Valore predefinito: machineNames.

facoltativo. Specifica un subset di computer specificando nomi o tag del computer.

MachineFilter - Eseguire la distribuzione nei computer
string.

Questo input è valido solo per i gruppi di computer e non è ancora supportato per un elenco semplice di computer o variabili di output.

Specifica un elenco di computer, ad esempio dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 o tag, ad esempio Role:DB; OS:Win8.1. Se vengono forniti più tag, l'attività verrà eseguita in tutti i computer con i tag specificati. Per i gruppi di risorse di Azure, specificare il nome della macchina virtuale, ad esempio ffweb, ffdb. Il valore predefinito esegue l'attività in tutti i computer.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Importante

Si tratta di un'attività deprecata. Usare la distribuzione di app Web IIS con WinRM - Viual Studio Marketplace.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.91.0 o versione successiva
Categoria attività	Distribuire