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

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 und wird am 31. Januar 2024 eingestellt. Verwenden Sie die IIS-Web-App-Bereitstellung mithilfe von 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.

Eingaben

EnvironmentName - Maschinen
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 - Admin Anmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.

AdminPassword - Passwort
string.

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

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 lautet HTTPS.

TestCertificate - Zertifikat testen
boolean. Optional. Verwenden Sie , wenn WinRMProtocol = Https. Standardwert. true.

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

WebDeployPackage - Webbereitstellungspaket
string. Erforderlich.

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

WebDeployParamFile - Parameterdatei für webbereitstellung
string.

Gibt den Speicherort der Parameterdatei auf den Zielcomputern oder in einem UNC-Pfad an. Die Parameterdatei wird verwendet, um Konfigurationseinstellungen für Webanwendungen zu überschreiben, z. B. den Namen der IIS-Webanwendung oder die datenbank Verbindungszeichenfolge.

OverRideParams - Parameter außer Kraft setzen
string.

Die hier angegebenen Parameter überschreiben die Parameter in der MSDeploy-ZIP-Datei und der Parameterdatei. Um mehrere Parameter zu überschreiben, verwenden Sie ein Zeilentrennzeichen.
Zum Beispiel: "IIS Web Application Name"="Fabrikam" oder "ConnectionString"="Server=localhost;Database=Fabrikam;".

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

Gibt die Option an, eine Website zu erstellen oder eine vorhandene Website zu aktualisieren.

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

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

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

Gibt den physischen Pfad an, in dem der Websiteinhalt gespeichert wird. Der Inhalt kann sich auf dem lokalen Computer oder in einem Remoteverzeichnis oder einer Freigabe wie C:\Fabrikam oder befinden \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Authentifizierung des physischen Pfads
string. Erforderlich, wenn CreateWebSite = true. Zulässige Werte: WebSiteUserPassThrough (Anwendungsbenutzer (Passthrough)), 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 - Passwort
string. Optional. Verwenden Sie , wenn WebSitePhysicalPathAuth = WebSiteWindowsAuth.

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

AddBinding - Bindung hinzufügen
boolean. Optional. Verwenden Sie , wenn CreateWebSite = true. Standardwert. true.

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

AssignDuplicateBinding - Duplikatbindung zuweisen
boolean. Optional. Verwenden Sie , wenn AddBinding = true. Standardwert. false.

Gibt die Option zum Hinzufügen der hier angegebenen Bindungen an (auch wenn eine andere Website mit den gleichen 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 für eine HTTP-Bindung oder HTTPS an, damit 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 zugewiesen ausgewählt ist, antwortet die Website auf Anforderungen nach allen IP-Adressen am Port und dem optionalen Hostnamen, der für den Standort angegeben ist. Der Standort reagiert nicht auf Anforderungen, wenn ein anderer Standort auf dem Server über eine Bindung am gleichen Port verfügt, jedoch mit einer bestimmten IP-Adresse.

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

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

ServerNameIndication - Angabe des Servernamens erforderlich
boolean. Optional. Verwenden Sie , wenn Protocol = https. Standardwert. false.

Bestimmt, ob die Website Servernamensanzeige (SNI) erfordert. SNI erweitert die SSL- und TLS-Protokolle, um anzugeben, mit welchem Hostnamen der Client eine Verbindung herstellen möchte. Diese Erweiterung ermöglicht es, dass mehrere sichere Websites mit verschiedenen Zertifikaten dieselbe IP-Adresse verwenden können.

HostNameWithOutSNI - Hostname
string. Optional. Verwenden Sie , 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 - Hostname
string. Optional. Verwenden Sie , 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 - Hostname
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-Zertifikatfingerdruck
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 eines Anwendungspools
boolean. Standardwert. false.

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

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

Gibt den Namen des zu erstellenden oder zu aktualisierenden IIS-Anwendungspools an. Der vorhandene Anwendungspool wird mit den angegebenen Einstellungen aktualisiert.

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

Gibt die Version der .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 - Verwalteter Pipelinemodus
string. Erforderlich, wenn CreateAppPool = true. Zulässige Werte: Integrated, Classic. Standardwert. Integrated.

Der Verwaltete Pipelinemodus 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ät
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 - Nutzername
string. Erforderlich, wenn AppPoolIdentity = SpecificUser.

AppPoolPassword - Passwort
string. Optional. Verwenden Sie , 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 an, um die Eigenschaften der Website oder des Anwendungspools festzulegen. Verwenden Sie für mehrere Befehle ein Zeilentrennzeichen.
Beispiel:
<Auflisten von App-Pools>
<list sites>

DeployInParallel - Parallele Bereitstellung
boolean. Standardwert. true.

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

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

Optional. Gibt eine Teilmenge der Computer an, indem Computernamen oder Tags angegeben werden.

MachineFilter - Bereitstellen 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 dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 . B. oder Tags, z. B Role:DB; OS:Win8.1. . Wenn mehrere Tags bereitgestellt werden, wird der Task 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.

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.

Hinweise

Wichtig

Diese Aufgabe ist veraltet. Verwenden der IIS-Web-App-Bereitstellung mithilfe von WinRM – Viual Studio Marketplace.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.91.0 oder höher
Aufgabenkategorie	Bereitstellen