IISWebAppDeploymentOnMachineGroup@0 - IIS-web-app v0-taak implementeren

Artikel
2025-03-24

Gebruik deze taak om een website of webtoepassing te implementeren met behulp van Web Deploy.

Syntaxis

# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: # string. Required. Website Name. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
  # Advanced Deployment Options
    #SetParametersFile: # string. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
    #AdditionalArguments: # string. Additional Arguments. 
  # File Transforms & Variable Substitution Options
    #XmlTransformation: false # boolean. XML transformation. Default: false.
    #XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
    #JSONFiles: # string. JSON variable substitution.

Invoer

WebSiteName - websitenaam
string. Verplicht.

Hiermee geeft u de naam van een bestaande website op de computergroep machines.

VirtualApplication - virtuele toepassing
string.

Hiermee geeft u de naam op van een al bestaande virtuele Azure-toepassing op de doelmachines.

Package - pakket of map
string. Verplicht. Standaardwaarde: $(System.DefaultWorkingDirectory)\**\*.zip.

Hiermee geeft u het bestandspad naar het pakket of de map gegenereerd door MSBuild of een gecomprimeerd archiefbestand. Variabelen (Build | Release) en jokertekens worden ondersteund. Bijvoorbeeld: $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - SetParameters-bestand
string.

Facultatief. Hiermee geeft u de locatie van het SetParameters.xml bestand te gebruiken.

RemoveAdditionalFilesFlag - Extra bestanden verwijderen op doel
boolean. Standaardwaarde: false.

Hiermee selecteert u de optie voor het verwijderen van bestanden in de web-app die geen overeenkomende bestanden in het zip-pakket van de web-app hebben.

ExcludeFilesFromAppDataFlag - Bestanden uitsluiten van de App_Data map
boolean. Standaardwaarde: false.

Hiermee selecteert u de optie om te voorkomen dat bestanden in de map App_Data worden geïmplementeerd in de web-app.

TakeAppOfflineFlag - app offline halen
boolean. Standaardwaarde: false.

Selecteert de optie om de web-app offline te halen door een app_offline.htm bestand in de hoofdmap van de web-app te plaatsen voordat de synchronisatiebewerking begint. Het bestand wordt verwijderd nadat de synchronisatiebewerking is voltooid.

AdditionalArguments - Aanvullende argumenten
string.

Hiermee geeft u aanvullende argumenten voor Web Deploy op die worden toegepast bij het implementeren van de Azure-web-app. Bijvoorbeeld -disableLink:AppPoolExtension of -disableLink:ContentExtension.

Zie Web Deploy Operation Settingsvoor een lijst met web-implementatieargumenten.

XmlTransformation - XML-transformatie
boolean. Standaardwaarde: false.

Hiermee geeft u de configuratietransformaties op die worden uitgevoerd voor *.Release.config en *.<EnvironmentName>.config op de *.config file. Configuratietransformaties worden uitgevoerd vóór de variabele vervanging. XML-transformaties worden alleen ondersteund in Windows.

XmlVariableSubstitution - xml-variabele vervangen
boolean. Standaardwaarde: false.

Hiermee geeft u de variabelen op die zijn gedefinieerd in de build- of release-pijplijn. Deze variabelen worden vergeleken met de key- of name vermeldingen in de secties appSettings, applicationSettings en connectionStrings van een configuratiebestand en parameters.xml. Variabele vervanging wordt uitgevoerd na configuratietransformaties.

Opmerking: Als dezelfde variabelen zijn gedefinieerd in de release-pijplijn en in de omgeving, vervangen de omgevingsvariabelen de releasepijplijnvariabelen.

JSONFiles - JSON-variabele vervangen
string.

Hiermee geeft u een nieuwe regel gescheiden lijst met JSON-bestanden om de variabele waarden te vervangen. Bestandsnamen moeten relatief zijn ten opzichte van de hoofdmap.

Als u JSON-variabelen wilt vervangen die genest of hiërarchisch zijn, geeft u deze op met behulp van JSONPath-expressies. Als u bijvoorbeeld de waarde van ConnectionString in het onderstaande voorbeeld wilt vervangen, moet u een variabele definiëren als Data.DefaultConnection.ConnectionString in de build- of release-pijplijn (of in de fase van de release-pijplijn).

{  
  "Data": {  
    "DefaultConnection": {  
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"  
    }  
  }  
}

Variabele vervanging wordt uitgevoerd na configuratietransformaties.

Opmerking: Pijplijnvariabelen worden uitgesloten in vervanging.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een website of web-app te implementeren met behulp van WebDeploy.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	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	2.104.1 of hoger
Taakcategorie	Implementeren

Delen via