IISWebAppDeploymentOnMachineGroup@0: Iis Web App deploy v0 task

Verwenden Sie diese Aufgabe, um eine Website oder Webanwendung mithilfe von Web Deploy bereitzustellen.

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.

Eingaben

WebSiteName - Websitename
string. Erforderlich.

Gibt den Namen einer vorhandenen Website auf den Computergruppencomputern an.

VirtualApplication - Virtuelle Anwendung
string.

Gibt den Namen einer bereits vorhandenen virtuellen Azure-Anwendung auf den Zielcomputern an.

Package - Paket oder Ordner
string. Erforderlich. Standardwert. $(System.DefaultWorkingDirectory)\**\*.zip.

Gibt den Dateipfad zum Paket oder Ordner an, der von MSBuild oder einer komprimierten Archivdatei generiert wurde. Variablen ( Build | release) und Wildcards werden unterstützt. Beispiel: $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - SetParameters-Datei
string.

Optional. Gibt den Speicherort der SetParameters.xml zu verwendenden Datei an.

RemoveAdditionalFilesFlag - Entfernen zusätzlicher Dateien am Ziel
boolean. Standardwert. false.

Wählt die Option zum Löschen von Dateien in der Web-App aus, die keine übereinstimmenden Dateien im Zip-Paket der Web-App enthalten.

ExcludeFilesFromAppDataFlag - Ausschließen von Dateien aus dem App_Data Ordner
boolean. Standardwert. false.

Wählt die Option aus, um zu verhindern, dass Dateien im App_Data Ordner in der Web-App bereitgestellt werden.

TakeAppOfflineFlag - Offline schalten der App
boolean. Standardwert. false.

Wählt die Option aus, die Web-App offline zu schalten, indem eine app_offline.htm Datei im Stammverzeichnis der Web-App abgelegt wird, bevor der Synchronisierungsvorgang beginnt. Die Datei wird entfernt, nachdem der Synchronisierungsvorgang erfolgreich abgeschlossen wurde.

AdditionalArguments - Zusätzliche Argumente
string.

Gibt zusätzliche Web Deploy-Argumente an, die beim Bereitstellen der Azure-Web-App angewendet werden. Zum Beispiel: -disableLink:AppPoolExtension oder -disableLink:ContentExtension.

Eine Liste mit Web Deploy-Argumenten finden Sie unter WebBereitstellungsvorgangseinstellungen.

XmlTransformation - XML-Transformation
boolean. Standardwert. false.

Gibt die Konfigurationstransformationen an, die für *.Release.config und *.<EnvironmentName>.config für *.config fileausgeführt werden. Konfigurationstransformationen werden vor der Variablenersetzung ausgeführt. XML-Transformationen werden nur unter Windows unterstützt.

XmlVariableSubstitution - Ersetzung von XML-Variablen
boolean. Standardwert. false.

Gibt die variablen an, die in der Build- oder Releasepipeline definiert sind. Diese Variablen werden mit den key Einträgen oder name in den Abschnitten appSettings, applicationSettings und connectionStrings jeder Konfigurationsdatei und parameters.xmlabgeglichen. Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Wenn dieselben Variablen in der Releasepipeline und in der Umgebung definiert sind, ersetzen die Umgebungsvariablen die Releasepipelinevariablen.

JSONFiles - JSON-Variablenersetzung
string.

Gibt eine neue zeilentrennte Liste von JSON-Dateien an, um die Variablenwerte zu ersetzen. Dateinamen müssen relativ zum Stammordner sein.

Um JSON-Variablen zu ersetzen, die geschachtelt oder hierarchisch sind, geben Sie sie mithilfe von JSONPath-Ausdrücken an. Um beispielsweise den Wert von ConnectionString im folgenden Beispiel zu ersetzen, müssen Sie eine Variable wie Data.DefaultConnection.ConnectionString in der Build- oder Releasepipeline (oder in der Phase der Releasepipeline) definieren.

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

Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Pipelinevariablen werden bei der Ersetzung ausgeschlossen.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Website oder Web-App mithilfe von WebDeploy bereitzustellen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	Klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.104.1 oder höher
Aufgabenkategorie	Bereitstellen