Freigeben über


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

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

Von Bedeutung

Dieser Vorgang funktioniert nur mit klassischen Pipelines. Verwenden Sie stattdessen die IIS Web App-Bereitstellung mit WinRM – Visual Studio Marketplace .

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 - Virtuelle Anwendung
string.

Gibt den Namen einer 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.


SetParametersFile - SetParameters-Datei
string.

Gibt den Pfad zu der SetParameters.xml zu verwendenden Datei an.


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

Wenn dieser Wert auf true", löscht Dateien in der Web App, für die keine übereinstimmenden Dateien im ZIP-Paket von Web App vorhanden sind.


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

Wenn dieser Wert festgelegt ist true, wird verhindert, dass Dateien im App_Data Ordner in der Web App bereitgestellt werden.


TakeAppOfflineFlag - App offline schalten
boolean. Standardwert: false.

Wählt die Option aus, die Web App offline zu schalten, indem eine app_offline.htm Datei im Stammverzeichnis platziert wird, bevor der Synchronisierungsvorgang beginnt. Die Datei wird automatisch 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 verwendet werden sollen. Beispiel: -disableLink:AppPoolExtension oder -disableLink:ContentExtension.

Eine vollständige Liste der unterstützten Argumente finden Sie unter Web Deploy Operation Settings.


XmlTransformation - XML-Transformation
boolean. Standardwert: false.

Führt XML-Transformationen für *.Release.config und *.<EnvironmentName>.config Dateien für die entsprechende *.config file. Diese Transformationen werden vor der Variablenersetzung angewendet. XML-Transformationen werden nur unter Windows unterstützt.


XmlVariableSubstitution - Ersetzen von XML-Variablen
boolean. Standardwert: false.

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

Hinweis

Wenn dieselben Variablen sowohl in der Releasepipeline als auch in der Umgebung definiert sind, haben die Umgebungsvariablen Vorrang vor den Releasepipelinevariablen.


JSONFiles - JSON-Variablenersetzung
string.

Gibt eine newlinetrennte Liste von JSON-Dateien für die Variablenersetzung an. Dateinamen müssen relativ zum Stammordner sein.

Verwenden Sie JSONPath-Ausdrücke, um geschachtelte oder hierarchische JSON-Variablen zu ersetzen. Um beispielsweise den Wert ConnectionString im folgenden Beispiel zu ersetzen, definieren Sie eine Variable wie Data.DefaultConnection.ConnectionString in der Build- oder Releasepipeline (oder in der Phase der Veröffentlichungspipeline).

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

Die Variablenersetzung wird nach Konfigurationstransformationen ausgeführt, und Pipelinevariablen werden von der Ersetzung ausgeschlossen.


Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Bemerkungen

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

Beispiele

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen Klassische Version
Läuft auf Agent, DeploymentGroup
Inanspruchnahme Nichts
Fähigkeiten 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