Freigeben über

IISWebAppDeployment@1 – IIS Web App-Bereitstellung (veraltet) v1-Aufgabe

  • Artikel

Verwenden Sie diese Aufgabe, um IIS Web App mithilfe von MSDeploy bereitzustellen und dann Websites und App-Pools zu erstellen oder zu aktualisieren.

Wichtig

Dieser Vorgang ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie IIS Web App-Bereitstellung mit WinRM – Viual Studio Marketplace.

Verwenden Sie diese Aufgabe, um IIS Web App mithilfe von MSDeploy bereitzustellen und dann Websites und App-Pools zu erstellen oder zu aktualisieren.

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie IIS Web App-Bereitstellung mit WinRM – Viual Studio Marketplace.

Syntax

# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Eingänge

EnvironmentName - Computer
string. Erforderlich.

Gibt eine durch Trennzeichen getrennte Liste von COMPUTER-IP-Adressen oder FQDNs zusammen mit Ports an. Der Standardport basiert auf dem ausgewählten Protokoll, z. B. dbserver.fabrikam.com oder dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Sie können auch die Ausgabevariable anderer Aufgaben bereitstellen, z. B. $(variableName).


AdminUserName - Administratoranmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.


AdminPassword - Kennwort
string.

Gibt das Administratorkennwort für die Zielcomputer an. Es kann Variablen akzeptieren, die in Build-/Releasedefinitionen definiert sind, z. B. $(passwordVariable). Sie können den Variablentyp als secret markieren, um ihn zu sichern.


WinRMProtocol - Protokoll-
string. Zulässige Werte: Http, Https.

Gibt das Protokoll an, das für die WinRM-Verbindung mit den Computern verwendet wird. Der Standardwert ist HTTPS.


TestCertificate - Testzertifikat
boolean. Wahlfrei. Wird verwendet, wenn WinRMProtocol = Https. Standardwert: true.

Wählt die Option aus, um die Gültigkeit des Zertifikats des Computers durch eine vertrauenswürdige Zertifizierungsstelle zu überspringen. Der Parameter ist für das WinRM-HTTPS-Protokoll erforderlich.


WebDeployPackage - Web Deploy Package
string. Erforderlich.

Gibt den Speicherort der ZIP-Datei (Web Deploy, MSDeploy) auf den Zielcomputern oder auf einem UNC-Pfad wie \\BudgetIT\WebDeploy\WebDeployPackage.zipan. Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen werden auch unterstützt, z. B. $env:windir, $env:systemrootund $env:windir\FabrikamFibre\Web.


WebDeployParamFile - Web Deploy-Parameterdatei
string.

Gibt den Speicherort der Parameterdatei auf den Zielcomputern oder auf einem UNC-Pfad an. Die Parameterdatei wird verwendet, um Konfigurationseinstellungen für Webanwendungen wie den IIS-Webanwendungsnamen oder die Datenbankverbindungszeichenfolge außer Kraft zu setzen.


OverRideParams - Außerkraftsetzen von Parametern
string.

Hier angegebene Parameter überschreiben die Parameter in der MSDeploy-ZIP-Datei und der Parameterdatei. Verwenden Sie ein Zeilentrennzeichen, um mehrere Parameter außer Kraft zu setzen.
Beispiel: "IIS Web Application Name"="Fabrikam" oder "ConnectionString"="Server=localhost;Database=Fabrikam;".


CreateWebSite - Website- erstellen oder aktualisieren
boolean. Standardwert: false.

Gibt die Option zum Erstellen einer Website oder zum Aktualisieren einer vorhandenen Website an.


WebSiteName - Websitename
string. Erforderlich, wenn CreateWebSite = true.

Gibt den Namen der IIS-Website an, die erstellt wird, wenn sie nicht vorhanden ist, oder wird aktualisiert, wenn sie bereits auf dem IIS-Server vorhanden ist. Der Name der Website sollte mit der in der Zip-Paketdatei für die Webbereitstellung angegebenen identisch sein. Wenn auch eine Parameterdatei und Parametereinstellung außer Kraft setzen, sollte der Name der Website mit der Einstellung "Außerkraftsetzungsparameter" identisch sein.


WebSitePhysicalPath - physischen Pfad
string. Erforderlich, wenn CreateWebSite = true. Standardwert: %SystemDrive%\inetpub\wwwroot.

Gibt den physischen Pfad an, in dem die Websiteinhalte gespeichert werden. Der Inhalt kann sich auf dem lokalen Computer oder in einem Remoteverzeichnis oder auf einer Freigabe befinden, z. B. C:\Fabrikam oder \\ContentShare\Fabrikam.


WebSitePhysicalPathAuth - physische Pfadauthentifizierung
string. Erforderlich, wenn CreateWebSite = true. Zulässige Werte: WebSiteUserPassThrough (Anwendungsbenutzer (Pass-Through)), WebSiteWindowsAuth (Windows-Authentifizierung). Standardwert: Application User (Pass-through).

Gibt den Authentifizierungsmechanismus für den Zugriff auf den physischen Pfad der Website an.


WebSiteAuthUserName - Benutzername
string. Erforderlich, wenn WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Gibt den Benutzernamen für den Zugriff auf den physischen Pfad der Website an.


WebSiteAuthUserPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Gibt das Kennwort für den Zugriff auf den physischen Pfad der Website an. Wenn Sie ein gMSA verwenden, ist dies nicht erforderlich.


AddBinding - Hinzufügen von Bindungs-
boolean. Wahlfrei. Wird verwendet, wenn CreateWebSite = true. Standardwert: true.

Gibt die Option zum Hinzufügen der Portbindung für die Website an.


AssignDuplicateBinding - Zuweisen doppelter Bindungs-
boolean. Wahlfrei. Wird verwendet, wenn AddBinding = true. Standardwert: false.

Gibt die Option zum Hinzufügen der hier angegebenen Bindungen an (auch wenn eine andere Website mit denselben Bindungen vorhanden ist). Wenn bindungskonflikte auftreten, wird nur eine der Websites gestartet.


Protocol - Protokoll-
string. Erforderlich, wenn AddBinding = true. Zulässige Werte: https, http. Standardwert: http.

Gibt entweder HTTP für die Website an, damit eine HTTP-Bindung oder HTTPS für die Website über eine SSL-Bindung (Secure Sockets Layer) verfügt.


IPAddress - IP-Adresse
string. Erforderlich, wenn AddBinding = true. Standardwert: All Unassigned.

Gibt eine IP-Adresse an, die Benutzer für den Zugriff auf die Website verwenden können. Wenn Alle nicht zugewiesenen ausgewählt ist, antwortet die Website auf Anforderungen für alle IP-Adressen am Port und den optionalen Hostnamen, der für die Website angegeben ist. Die Website antwortet nicht auf Anforderungen, wenn ein anderer Standort auf dem Server über eine Bindung am selben Port verfügt, aber mit einer bestimmten IP-Adresse.


Port - Port
string. Erforderlich, wenn AddBinding = true. Standardwert: 80.

Gibt den Port an, auf dem hypertext Transfer Protocol Stack (HTTP.sys) auf Anforderungen überwacht werden muss, die an diese Website gestellt werden.


ServerNameIndication - Servernamensanzeige erforderlich
boolean. Wahlfrei. Wird verwendet, wenn Protocol = https. Standardwert: false.

Bestimmt, ob für die Website Server Name Indication (SNI) erforderlich ist. SNI erweitert die SSL- und TLS-Protokolle, um anzugeben, mit welchem Hostnamen der Client eine Verbindung herstellen möchte. Sie ermöglicht es mehreren sicheren Websites mit unterschiedlichen Zertifikaten, dieselbe IP-Adresse zu verwenden.


HostNameWithOutSNI - Hostnamen
string. Wahlfrei. Wird verwendet, wenn ServerNameIndication = false.

Weist einem Computer, der eine einzelne IP-Adresse verwendet, einen oder mehrere Hostnamen (oder Domänennamen) zu. Wenn ein Hostname angegeben wird, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.


HostNameWithHttp - Hostnamen
string. Wahlfrei. Wird verwendet, wenn Protocol = http.

Weist einem Computer, der eine einzelne IP-Adresse verwendet, einen oder mehrere Hostnamen (oder Domänennamen) zu. Wenn ein Hostname angegeben wird, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.


HostNameWithSNI - Hostnamen
string. Erforderlich, wenn ServerNameIndication = true.

Weist einem Computer, der eine einzelne IP-Adresse verwendet, einen oder mehrere Hostnamen (oder Domänennamen) zu. Wenn ein Hostname angegeben wird, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.


SSLCertThumbPrint - SSL-Zertifikatfingerabdruck
string. Erforderlich, wenn Protocol = https.

Gibt den Fingerabdruck des Secure Socket Layer-Zertifikats an, das die Website verwenden wird. Das Zertifikat sollte bereits auf dem Computer installiert und im persönlichen Speicher des lokalen Computers vorhanden sein.


CreateAppPool - Erstellen oder Aktualisieren des Anwendungspools
boolean. Standardwert: false.

Gibt die Option zum Erstellen eines Anwendungspools oder zum Aktualisieren eines vorhandenen Anwendungspools an.


AppPoolName - Name
string. Erforderlich, wenn CreateAppPool = true.

Gibt den Namen des IIS-Anwendungspools an, der erstellt oder aktualisiert werden soll. Der vorhandene Anwendungspool wird mit den angegebenen Einstellungen aktualisiert.


DotNetVersion - .NET Version
string. Erforderlich, wenn CreateAppPool = true. Zulässige Werte: v4.0, v2.0, No Managed Code. Standardwert: v4.0.

Gibt die Version von .NET Framework an, die von diesem Anwendungspool geladen wird. Wenn die diesem Anwendungspool zugewiesenen Anwendungen keinen verwalteten Code enthalten, wählen Sie in der Liste die Option Kein verwalteter Code aus.


PipeLineMode - verwalteten Pipelinemodus
string. Erforderlich, wenn CreateAppPool = true. Zulässige Werte: Integrated, Classic. Standardwert: Integrated.

Der Modus für verwaltete Pipeline gibt an, wie IIS Anforderungen für verwaltete Inhalte verarbeitet. Verwenden Sie den klassischen Modus nur, wenn die Anwendungen im Anwendungspool nicht im integrierten Modus ausgeführt werden können.


AppPoolIdentity - Identitäts-
string. Erforderlich, wenn CreateAppPool = true. Zulässige Werte: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (benutzerdefiniertes Konto). Standardwert: ApplicationPoolIdentity.

Konfiguriert das Konto, unter dem der Arbeitsprozess eines Anwendungspools ausgeführt wird. Geben Sie eines der vordefinierten Sicherheitskonten an, oder konfigurieren Sie ein benutzerdefiniertes Konto.


AppPoolUsername - Benutzername
string. Erforderlich, wenn AppPoolIdentity = SpecificUser.


AppPoolPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn AppPoolIdentity = SpecificUser.

Wenn Sie ein gMSA verwenden, ist dies nicht erforderlich.


AppCmdCommands - zusätzliche AppCmd.exe Befehle
string.

Gibt zusätzliche AppCmd.exe Befehle zum Festlegen der Website- oder Anwendungspooleigenschaften an. Verwenden Sie für mehrere Befehle ein Zeilentrennzeichen.
Beispiel:
<Listen-App-Pools>
<Listenwebsites>


DeployInParallel - Parallel bereitstellen
boolean. Standardwert: true.

Bei Festlegung auf truewird die Webanwendung auf den Zielcomputern parallel bereitgestellt.


ResourceFilteringMethod - Computer nach auswählen
string. Zulässige Werte: machineNames (Computernamen), tags. Standardwert: machineNames.

Wahlfrei. Gibt eine Teilmenge von Computern an, indem Computernamen oder -tags bereitgestellt werden.


MachineFilter - Bereitstellung auf Computern
string.

Diese Eingabe ist nur für Computergruppen gültig und wird für eine flache Liste von Computern oder Ausgabevariablen noch nicht unterstützt.

Gibt eine Liste von Computern an, z. B. dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 oder Tags, z. B. Role:DB; OS:Win8.1. Wenn mehrere Tags bereitgestellt werden, wird die Aufgabe auf allen Computern mit den angegebenen Tags ausgeführt. Geben Sie für Azure-Ressourcengruppen den Namen des virtuellen Computers an, z. B. ffweb, ffdb. Standardmäßig wird die Aufgabe auf allen Computern ausgeführt.


Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Bemerkungen

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie IIS Web App-Bereitstellung mit WinRM – Viual Studio Marketplace.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
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 1.91.0 oder höher
Vorgangskategorie Einsetzen