Delen via


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

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

Belangrijk

Deze taak werkt alleen met klassieke pijplijnen. Gebruik in plaats daarvan IIS-web-app-implementatie met WinRM - Visual Studio Marketplace .

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 van een 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 die is gegenereerd door MSBuild of naar een gecomprimeerd archiefbestand. Variabelen (buildrelease | ) en jokertekens worden ondersteund.


SetParametersFile - SetParameters-bestand
string.

Hiermee geeft u het pad naar het SetParameters.xml bestand dat moet worden gebruikt.


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

Als deze optie is ingesteld true, verwijdert u bestanden in de web-app die geen overeenkomende bestanden hebben in het ZIP-pakket van de web-app.


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

Als deze optie is ingesteld true, voorkomt u dat bestanden in de App_Data map 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 te plaatsen voordat de synchronisatiebewerking begint. Het bestand wordt automatisch verwijderd nadat de synchronisatiebewerking is voltooid.


AdditionalArguments - Aanvullende argumenten
string.

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

Zie Web Deploy Operation Settings voor een volledige lijst met ondersteunde argumenten.


XmlTransformation - XML-transformatie
boolean. Standaardwaarde: false.

Voert XML-transformaties voor *.Release.config en *.<EnvironmentName>.config bestanden uit op de bijbehorende *.config file. Deze transformaties worden toegepast voordat variabelen worden vervangen. XML-transformaties worden alleen ondersteund in Windows.


XmlVariableSubstitution - VERVANGING van XML-variabele
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 appSettings, applicationSettingsen connectionStrings secties van een configuratiebestand en parameters.xml. Variabele vervanging wordt uitgevoerd na configuratietransformaties.

Opmerking

Als dezelfde variabelen zijn gedefinieerd in zowel de release-pijplijn als de omgeving, hebben de omgevingsvariabelen voorrang op de releasepijplijnvariabelen.


JSONFiles - Vervanging van JSON-variabele
string.

Hiermee geeft u een door nieuwe regels gescheiden lijst met JSON-bestanden op voor het vervangen van variabelen. Bestandsnamen moeten relatief zijn ten opzichte van de hoofdmap.

Als u geneste of hiërarchische JSON-variabelen wilt vervangen, gebruikt u JSONPath-expressies. Als u bijvoorbeeld de waarde in ConnectionString het onderstaande voorbeeld wilt vervangen, definieert u een variabele zoals 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"  
    }  
  }  
}

Het vervangen van variabelen wordt uitgevoerd na configuratietransformaties en pijplijnvariabelen worden uitgesloten van vervanging.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Voorbeelden

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