Delen via

IISWebAppDeployment@1 - IIS-web-app-implementatie (afgeschaft) v1-taak

  • Artikel

Gebruik deze taak om IIS-web-app te implementeren met MSDeploy en vervolgens websites en app-pools te maken of bij te werken.

Belangrijk

Deze taak is afgeschaft en wordt buiten gebruik gesteld op 31 januari 2024. Gebruik IIS-web-app-implementatie met WinRM - Viual Studio Marketplace.

Gebruik deze taak om IIS-web-app te implementeren met MSDeploy en vervolgens websites en app-pools te maken of bij te werken.

Belangrijk

Deze taak is afgeschaft. Gebruik IIS-web-app-implementatie met WinRM - Viual Studio Marketplace.

Syntaxis

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

Invoer

EnvironmentName - Machines
string. Verplicht.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van computers, samen met poorten. De standaardpoort is gebaseerd op het geselecteerde protocol, bijvoorbeeld dbserver.fabrikam.com of dbserver_int.fabrikam.com:5986,192.168.12.34:5986. U kunt ook de uitvoervariabele van andere taken opgeven, bijvoorbeeld $(variableName).


AdminUserName - aanmeldgegevens van beheerders
string.

Hiermee geeft u de beheerdersaanmelding voor de doelcomputers.


AdminPassword - wachtwoord
string.

Hiermee geeft u het beheerderswachtwoord voor de doelmachines. Het kan variabelen accepteren die zijn gedefinieerd in build-/releasedefinities, zoals $(passwordVariable). U kunt het variabeletype markeren als secret om het te beveiligen.


WinRMProtocol - Protocol
string. Toegestane waarden: Http, Https.

Hiermee geeft u het protocol dat wordt gebruikt voor de WinRM-verbinding met de machine(s). De standaardwaarde is HTTPS.


TestCertificate - certificaat testen
boolean. Facultatief. Gebruiken wanneer WinRMProtocol = Https. Standaardwaarde: true.

Hiermee selecteert u de optie om de echtheid van het certificaat van de machine door een vertrouwde certificeringsinstantie over te slaan. De parameter is vereist voor het WinRM-HTTPS-protocol.


WebDeployPackage - Web Deploy Package
string. Verplicht.

Hiermee geeft u de locatie van het ZIP-bestand (Web Deploy) (MSDeploy) op de doelcomputers of op een UNC-pad zoals, \\BudgetIT\WebDeploy\WebDeployPackage.zip. Het UNC-pad moet toegankelijk zijn voor het beheerdersaccount van de computer. Omgevingsvariabelen worden ook ondersteund, zoals $env:windir, $env:systemrooten $env:windir\FabrikamFibre\Web.


WebDeployParamFile - parameterbestand voor web implementeren
string.

Hiermee geeft u de locatie van het parameterbestand op de doelcomputers of op een UNC-pad. Het parameterbestand wordt gebruikt om configuratie-instellingen voor webtoepassingen te overschrijven, zoals de naam van de IIS-webtoepassing of databaseverbindingsreeks.


OverRideParams - Parameters overschrijven
string.

Parameters die hier worden opgegeven, overschrijven de parameters in het ZIP-bestand MSDeploy en het parameterbestand. Als u meer dan één parameter wilt overschrijven, gebruikt u een regelscheidingsteken.
Bijvoorbeeld "IIS Web Application Name"="Fabrikam" of "ConnectionString"="Server=localhost;Database=Fabrikam;".


CreateWebSite - Website- maken of bijwerken
boolean. Standaardwaarde: false.

Hiermee geeft u de optie om een website te maken of een bestaande website bij te werken.


WebSiteName - websitenaam
string. Vereist wanneer CreateWebSite = true.

Hiermee geeft u de naam op van de IIS-website die wordt gemaakt als deze niet bestaat of wordt bijgewerkt als deze al aanwezig is op de IIS-server. De naam van de website moet gelijk zijn aan de naam die is opgegeven in het zip-pakketbestand voor web-deploy. Als er ook een parameterbestand en instelling voor het overschrijven van parameters is opgegeven, moet de naam van de website hetzelfde zijn als die in de instelling voor onderdrukkingsparameters.


WebSitePhysicalPath - fysiek pad
string. Vereist wanneer CreateWebSite = true. Standaardwaarde: %SystemDrive%\inetpub\wwwroot.

Hiermee geeft u het fysieke pad op waar de website-inhoud wordt opgeslagen. De inhoud kan zich op de lokale computer of in een externe map of share bevinden, zoals C:\Fabrikam of \\ContentShare\Fabrikam.


verificatie van fysieke paden WebSitePhysicalPathAuth -
string. Vereist wanneer CreateWebSite = true. Toegestane waarden: WebSiteUserPassThrough (toepassingsgebruiker (passthrough)), WebSiteWindowsAuth (Windows-verificatie). Standaardwaarde: Application User (Pass-through).

Hiermee geeft u het verificatiemechanisme voor toegang tot het fysieke pad van de website.


WebSiteAuthUserName - gebruikersnaam
string. Vereist wanneer WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Hiermee geeft u de gebruikersnaam voor toegang tot het fysieke pad van de website.


WebSiteAuthUserPassword - wachtwoord
string. Facultatief. Gebruiken wanneer WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Hiermee geeft u het wachtwoord op voor toegang tot het fysieke pad van de website. Als u een gMSA gebruikt, is dit niet vereist.


AddBinding - Binding toevoegen
boolean. Facultatief. Gebruiken wanneer CreateWebSite = true. Standaardwaarde: true.

Hiermee geeft u de optie voor het toevoegen van poortbinding voor de website.


AssignDuplicateBinding - Dubbele binding toewijzen
boolean. Facultatief. Gebruiken wanneer AddBinding = true. Standaardwaarde: false.

Hiermee geeft u de optie om de hier opgegeven bindingen toe te voegen (zelfs als er een andere website met dezelfde bindingen is). Als er bindende conflicten zijn, wordt slechts één van de websites gestart.


Protocol - Protocol
string. Vereist wanneer AddBinding = true. Toegestane waarden: https, http. Standaardwaarde: http.

Hiermee geeft u op dat http voor de website een HTTP-binding of HTTPS moet hebben voor de website om een SSL-binding (Secure Sockets Layer) te hebben.


IPAddress - IP-adres
string. Vereist wanneer AddBinding = true. Standaardwaarde: All Unassigned.

Hiermee geeft u een IP-adres op dat gebruikers kunnen gebruiken voor toegang tot de website. Als alle niet-toegewezen is geselecteerd, reageert de site op aanvragen voor alle IP-adressen op de poort en de optionele hostnaam die voor de site is opgegeven. De site reageert niet op aanvragen als een andere site op de server een binding op dezelfde poort heeft, maar met een specifiek IP-adres.


Port - poort
string. Vereist wanneer AddBinding = true. Standaardwaarde: 80.

Hiermee geeft u de poort op waarop Hypertext Transfer Protocol Stack (HTTP.sys) moet controleren op aanvragen die zijn gedaan op deze website.


ServerNameIndication - servernaamindicatie vereist
boolean. Facultatief. Gebruiken wanneer Protocol = https. Standaardwaarde: false.

Bepaalt of voor de website servernaamindicatie (SNI) is vereist. SNI breidt de SSL- en TLS-protocollen uit om aan te geven met welke hostnaam de client verbinding probeert te maken. Hiermee kunnen meerdere beveiligde websites met verschillende certificaten hetzelfde IP-adres gebruiken.


HostNameWithOutSNI - hostnaam
string. Facultatief. Gebruiken wanneer ServerNameIndication = false.

Hiermee wijst u een of meer hostnamen (of domeinnamen) toe aan een computer die één IP-adres gebruikt. Als er een hostnaam is opgegeven, moeten de clients de hostnaam gebruiken in plaats van het IP-adres om toegang te krijgen tot de website.


HostNameWithHttp - hostnaam
string. Facultatief. Gebruiken wanneer Protocol = http.

Hiermee wijst u een of meer hostnamen (of domeinnamen) toe aan een computer die één IP-adres gebruikt. Als er een hostnaam is opgegeven, moeten de clients de hostnaam gebruiken in plaats van het IP-adres om toegang te krijgen tot de website.


HostNameWithSNI - hostnaam
string. Vereist wanneer ServerNameIndication = true.

Hiermee wijst u een of meer hostnamen (of domeinnamen) toe aan een computer die één IP-adres gebruikt. Als er een hostnaam is opgegeven, moeten de clients de hostnaam gebruiken in plaats van het IP-adres om toegang te krijgen tot de website.


SSLCertThumbPrint - vingerafdruk van SSL-certificaat afdrukken
string. Vereist wanneer Protocol = https.

Hiermee geeft u de vingerafdruk van het Secure Socket Layer-certificaat dat de website gaat gebruiken. Het certificaat moet al op de computer zijn geïnstalleerd en aanwezig zijn in het persoonlijke archief van de lokale computer.


CreateAppPool - groep van toepassingen maken of bijwerken
boolean. Standaardwaarde: false.

Hiermee geeft u de optie om een groep van toepassingen te maken of een bestaande groep van toepassingen bij te werken.


AppPoolName - naam
string. Vereist wanneer CreateAppPool = true.

Hiermee geeft u de naam op van de GROEP van IIS-toepassingen die moet worden gemaakt of bijgewerkt. De bestaande groep van toepassingen wordt bijgewerkt met de opgegeven instellingen.


DotNetVersion - .NET-versie
string. Vereist wanneer CreateAppPool = true. Toegestane waarden: v4.0, v2.0, No Managed Code. Standaardwaarde: v4.0.

Hiermee geeft u de versie op van het .NET Framework dat door deze groep van toepassingen wordt geladen. Als de toepassingen die zijn toegewezen aan deze groep van toepassingen geen beheerde code bevatten, selecteert u de optie Geen beheerde code in de lijst.


PipeLineMode - beheerde pijplijnmodus
string. Vereist wanneer CreateAppPool = true. Toegestane waarden: Integrated, Classic. Standaardwaarde: Integrated.

De modus Beheerde pijplijn geeft aan hoe IIS aanvragen voor beheerde inhoud verwerkt. Gebruik de klassieke modus alleen als de toepassingen in de groep van toepassingen niet kunnen worden uitgevoerd in de geïntegreerde modus.


AppPoolIdentity - identiteit
string. Vereist wanneer CreateAppPool = true. Toegestane waarden: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (aangepast account). Standaardwaarde: ApplicationPoolIdentity.

Hiermee configureert u het account waaronder het werkproces van een groep van toepassingen wordt uitgevoerd. Geef een van de vooraf gedefinieerde beveiligingsaccounts op of configureer een aangepast account.


AppPoolUsername - gebruikersnaam
string. Vereist wanneer AppPoolIdentity = SpecificUser.


AppPoolPassword - wachtwoord
string. Facultatief. Gebruiken wanneer AppPoolIdentity = SpecificUser.

Als u een gMSA gebruikt, is dit niet vereist.


AppCmdCommands - aanvullende AppCmd.exe opdrachten
string.

Hiermee geeft u aanvullende AppCmd.exe opdrachten voor het instellen van de eigenschappen van de website of groep van toepassingen. Gebruik voor meer dan één opdracht een regelscheidingsteken.
Voorbeeld:
<lijst met app-pools>
<lijstsites>


DeployInParallel - implementeren in parallelle
boolean. Standaardwaarde: true.

Als deze optie is ingesteld op true, wordt de webtoepassing parallel geïmplementeerd op de doelcomputers.


ResourceFilteringMethod - Machines selecteren op
string. Toegestane waarden: machineNames (machinenamen), tags. Standaardwaarde: machineNames.

Facultatief. Hiermee geeft u een subset van machines op door computernamen of tags op te geven.


MachineFilter - implementeren op machines
string.

Deze invoer is alleen geldig voor machinegroepen en wordt nog niet ondersteund voor een platte lijst met machines of uitvoervariabelen.

Hiermee geeft u een lijst met machines, zoals dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 of tags, zoals Role:DB; OS:Win8.1. Als er meerdere tags worden opgegeven, wordt de taak uitgevoerd op alle computers met de opgegeven tags. Geef voor Azure-resourcegroepen de naam van de virtuele machine op, zoals ffweb, ffdb. Met de standaardinstelling wordt de taak op alle computers uitgevoerd.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Belangrijk

Deze taak is afgeschaft. Gebruik IIS-web-app-implementatie met WinRM - Viual Studio Marketplace.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 1.91.0 of hoger
Taakcategorie Implementeren