Share via


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

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

Syntax

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

Invoerwaarden

WebSiteName - Websitenaam
string. Vereist.

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. Vereist. Standaardwaarde: $(System.DefaultWorkingDirectory)\**\*.zip.

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


SetParametersFile - SetParameters-bestand
string.

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


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

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

Selecteert de optie om te voorkomen 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 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 Settings (Web Deploy Operation Settings) voor een lijst met argumenten voor Web Deploy.


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 vervanging van variabelen. 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 vermeldingen of name in de secties appSettings, applicationSettings en connectionStrings van elk configuratiebestand en parameters.xml. Variabele vervangen 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 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"  
    }  
  }  
}

Variabele vervangen wordt uitgevoerd na configuratietransformaties.

Opmerking: Pijplijnvariabelen worden uitgesloten in 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.

Vereisten

Vereiste Beschrijving
Pijplijntypen Klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.104.1 of hoger
Taakcategorie Implementeren
Vereiste Beschrijving
Pijplijntypen Klassieke release
Wordt uitgevoerd op DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.104.1 of hoger
Taakcategorie Implementeren