IISWebAppDeploymentOnMachineGroup@0 – Bereitstellen einer v0-Aufgabe in IIS Web App

Artikel
2025-03-24

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.

Eingänge

WebSiteName - Websitename
string. Erforderlich.

Gibt den Namen einer vorhandenen Website auf den Computergruppencomputern an.

VirtualApplication - virtual application
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, das von MSBuild oder einer komprimierten Archivdatei generiert wird. Variablen ( Build | Release) und Wildcards werden unterstützt. Beispiel: $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - SetParameters File
string.

Wahlfrei. Gibt den Speicherort der zu verwendenden SetParameters.xml 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 Web App-ZIP-Paket enthalten.

ExcludeFilesFromAppDataFlag - Dateien aus dem App_Data Ordner ausschließen
boolean. Standardwert: false.

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

TakeAppOfflineFlag - App offline
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 platziert 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. Beispiel: -disableLink:AppPoolExtension oder -disableLink:ContentExtension.

Eine Liste der Web Deploy-Argumente finden Sie unter Web Deploy Operation Settings.

XmlTransformation - XML-Transformation
boolean. Standardwert: false.

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

XmlVariableSubstitution - XML-Variablenersetzung
boolean. Standardwert: false.

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

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

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 als Data.DefaultConnection.ConnectionString in der Build- oder Releasepipeline (oder in der Phase der Veröffentlichungspipeline) definieren.

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

Die Variable Substitution wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Pipelinevariablen werden bei der Ersetzung ausgeschlossen.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	Klassische Version
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.104.1 oder höher
Vorgangskategorie	Einsetzen

Freigeben über