IISWebAppDeployment@1 – IIS Web App-distribution (inaktuell) v1-uppgift

Använd den här uppgiften för att distribuera IIS Web App med MSDeploy och skapa eller uppdatera webbplatser och apppooler.

Viktigt

Den här uppgiften är inaktuell och dras tillbaka den 31 januari 2024. Använd distribution av IIS-webbappar med 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.

Indata

EnvironmentName - Maskiner
string. Krävs.

Anger en kommaavgränsad lista över datorns IP-adresser eller FQDN tillsammans med portar. Standardporten baseras på det valda protokollet, till exempel dbserver.fabrikam.com eller dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Du kan också ange utdatavariabeln för andra aktiviteter, till exempel $(variableName).

AdminUserName - Admin inloggning
string.

Anger administratörsinloggning för måldatorerna.

AdminPassword - Lösenord
string.

Anger administratörslösenordet för måldatorerna. Den kan acceptera variabler som definierats i versionsdefinitioner, till exempel $(passwordVariable). Du kan markera variabeltypen som secret för att skydda den.

WinRMProtocol - Protokollet
string. Tillåtna värden: Http, Https.

Anger det protokoll som används för WinRM-anslutningen med datorerna. Standardvärdet är HTTPS.

TestCertificate - Testcertifikat
boolean. Valfritt. Använd när WinRMProtocol = Https. Standardvärde: true.

Väljer alternativet för att hoppa över verifieringen av datorns certifikat av en betrodd certifikatutfärdare. Parametern krävs för WinRM-protokollet HTTPS .

WebDeployPackage - Webbdistributionspaket
string. Krävs.

Anger platsen för zip-filen Web Deploy (MSDeploy) på måldatorerna eller på en UNC-sökväg som , \\BudgetIT\WebDeploy\WebDeployPackage.zip. UNC-sökvägen ska vara tillgänglig för datorns administratörskonto. Miljövariabler stöds också, till exempel $env:windir, $env:systemrootoch $env:windir\FabrikamFibre\Web.

WebDeployParamFile - Parameterfil för webbdistribution
string.

Anger platsen för parameterfilen på måldatorerna eller på en UNC-sökväg. Parameterfilen används för att åsidosätta konfigurationsinställningar för webbprogram, till exempel IIS-webbprogramnamnet eller databasens anslutningssträng.

OverRideParams - Åsidosätt parametrar
string.

Parametrar som anges här åsidosätter parametrarna i ZIP-filen MSDeploy och parameterfilen. Om du vill åsidosätta fler än en parameter använder du en radavgränsare.
Exempel: "IIS Web Application Name"="Fabrikam" eller "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Skapa eller uppdatera webbplats
boolean. Standardvärde: false.

Anger alternativet att skapa en webbplats eller uppdatera en befintlig webbplats.

WebSiteName - Webbplatsnamn
string. Krävs när CreateWebSite = true.

Anger namnet på den IIS-webbplats som skapas om den inte finns eller uppdateras om den redan finns på IIS-servern. Namnet på webbplatsen ska vara samma som det som anges i zip-paketfilen för webbdistribution. Om en parameterfil och inställning för åsidosättningsparametrar också anges ska namnet på webbplatsen vara samma som i inställningen för åsidosättningsparametrar.

WebSitePhysicalPath - Fysisk sökväg
string. Krävs när CreateWebSite = true. Standardvärde: %SystemDrive%\inetpub\wwwroot.

Anger den fysiska sökväg där webbplatsinnehållet lagras. Innehållet kan finnas på den lokala datorn eller i en fjärrkatalog eller resurs, till exempel C:\Fabrikam eller \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Fysisk sökvägsautentisering
string. Krävs när CreateWebSite = true. Tillåtna värden: WebSiteUserPassThrough (Programanvändare (direkt)), WebSiteWindowsAuth (Windows-autentisering). Standardvärde: Application User (Pass-through).

Anger autentiseringsmekanismen för åtkomst till webbplatsens fysiska sökväg.

WebSiteAuthUserName - Användarnamn
string. Krävs när WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Anger användarnamnet för åtkomst till webbplatsens fysiska sökväg.

WebSiteAuthUserPassword - Lösenord
string. Valfritt. Använd när WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Anger lösenordet för åtkomst till webbplatsens fysiska sökväg. Om du använder en gMSA krävs inte detta.

AddBinding - Lägg till bindning
boolean. Valfritt. Använd när CreateWebSite = true. Standardvärde: true.

Anger alternativet för att lägga till portbindning för webbplatsen.

AssignDuplicateBinding - Tilldela dubblettbindning
boolean. Valfritt. Använd när AddBinding = true. Standardvärde: false.

Anger alternativet för att lägga till bindningarna som anges här (även om det finns en annan webbplats med samma bindningar). Om det finns bindningskonflikter startar bara en av webbplatserna.

Protocol - Protokollet
string. Krävs när AddBinding = true. Tillåtna värden: https, http. Standardvärde: http.

Anger antingen HTTP för att webbplatsen ska ha en HTTP-bindning eller HTTPS för att webbplatsen ska ha en SSL-bindning (Secure Sockets Layer).

IPAddress - IP-adress
string. Krävs när AddBinding = true. Standardvärde: All Unassigned.

Anger en IP-adress som användarna kan använda för att komma åt webbplatsen. Om Alla otilldelade har valts svarar webbplatsen på begäranden för alla IP-adresser på porten och det valfria värdnamnet som har angetts för platsen. Webbplatsen svarar inte på begäranden om en annan plats på servern har en bindning på samma port men med en specifik IP-adress.

Port - Port
string. Krävs när AddBinding = true. Standardvärde: 80.

Anger den port där Hypertext Transfer Protocol Stack (HTTP.sys) måste övervaka för begäranden som görs på den här webbplatsen.

ServerNameIndication - Servernamnindikator krävs
boolean. Valfritt. Använd när Protocol = https. Standardvärde: false.

Avgör om webbplatsen kräver SNI (Server Name Indication). SNI utökar SSL- och TLS-protokollen för att ange vilket värdnamn klienten försöker ansluta till. Det gör att flera säkra webbplatser med olika certifikat kan använda samma IP-adress.

HostNameWithOutSNI - Värdnamn
string. Valfritt. Använd när ServerNameIndication = false.

Tilldelar ett eller flera värdnamn (eller domännamn) till en dator som använder en enda IP-adress. Om ett värdnamn anges måste klienterna använda värdnamnet i stället för IP-adressen för att få åtkomst till webbplatsen.

HostNameWithHttp - Värdnamn
string. Valfritt. Använd när Protocol = http.

Tilldelar ett eller flera värdnamn (eller domännamn) till en dator som använder en enda IP-adress. Om ett värdnamn anges måste klienterna använda värdnamnet i stället för IP-adressen för att få åtkomst till webbplatsen.

HostNameWithSNI - Värdnamn
string. Krävs när ServerNameIndication = true.

Tilldelar ett eller flera värdnamn (eller domännamn) till en dator som använder en enda IP-adress. Om ett värdnamn anges måste klienterna använda värdnamnet i stället för IP-adressen för att få åtkomst till webbplatsen.

SSLCertThumbPrint - Tumutskrift för SSL-certifikat
string. Krävs när Protocol = https.

Anger tumavtrycket för secure socket layer-certifikatet som webbplatsen ska använda. Certifikatet bör redan vara installerat på datorn och finnas under det lokala datorarkivet.

CreateAppPool - Skapa eller uppdatera programpool
boolean. Standardvärde: false.

Anger alternativet att skapa en programpool eller uppdatera en befintlig programpool.

AppPoolName - Namn
string. Krävs när CreateAppPool = true.

Anger namnet på den IIS-programpool som ska skapas eller uppdateras. Den befintliga programpoolen uppdateras med de angivna inställningarna.

DotNetVersion - .NET-version
string. Krävs när CreateAppPool = true. Tillåtna värden: v4.0, v2.0, No Managed Code. Standardvärde: v4.0.

Anger vilken version av .NET Framework som läses in av den här programpoolen. Om de program som tilldelats den här programpoolen inte innehåller hanterad kod väljer du alternativet Ingen hanterad kod i listan.

PipeLineMode - Hanterat pipelineläge
string. Krävs när CreateAppPool = true. Tillåtna värden: Integrated, Classic. Standardvärde: Integrated.

Läget för hanterad pipeline anger hur IIS bearbetar begäranden för hanterat innehåll. Använd endast klassiskt läge när programmen i programpoolen inte kan köras i integrerat läge.

AppPoolIdentity - Identitet
string. Krävs när CreateAppPool = true. Tillåtna värden: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (anpassat konto). Standardvärde: ApplicationPoolIdentity.

Konfigurerar det konto under vilket en programpools arbetsprocess körs. Ange ett av de fördefinierade säkerhetskontona eller konfigurera ett anpassat konto.

AppPoolUsername - Användarnamn
string. Krävs när AppPoolIdentity = SpecificUser.

AppPoolPassword - Lösenord
string. Valfritt. Använd när AppPoolIdentity = SpecificUser.

Om du använder en gMSA krävs inte detta.

AppCmdCommands - Ytterligare AppCmd.exe kommandon
string.

Anger ytterligare AppCmd.exe kommandon för att ange egenskaper för webbplatsen eller programpoolen. För mer än ett kommando använder du en radavgränsare.
Exempel:
<lista apppooler>
<listwebbplatser>

DeployInParallel - Distribuera parallellt
boolean. Standardvärde: true.

Om det är inställt truepå distribueras webbprogrammet parallellt på måldatorerna.

ResourceFilteringMethod - Välj Datorer efter
string. Tillåtna värden: machineNames (datornamn), tags. Standardvärde: machineNames.

Valfritt. Anger en delmängd av datorerna genom att ange datornamn eller taggar.

MachineFilter - Distribuera till datorer
string.

Dessa indata är endast giltiga för datorgrupper och stöds inte för en platt lista över datorer eller utdatavariabler ännu.

Anger en lista över datorer, till exempel dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 eller taggar, till exempel Role:DB; OS:Win8.1. Om flera taggar anges körs uppgiften på alla datorer med de angivna taggarna. För Azure-resursgrupper anger du namnet på den virtuella datorn, till exempel ffweb, ffdb. Standardinställningen kör aktiviteten på alla datorer.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Viktigt

Den här uppgiften är inaktuell. Använd distribution av IIS-webbappar med WinRM – Viual Studio Marketplace.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	1.91.0 eller senare
Uppgiftskategori	Distribuera