IISWebAppDeployment@1 – IIS-webalkalmazás üzembe helyezése (elavult) v1 feladat

Ezzel a feladattal üzembe helyezheti az IIS-webalkalmazást az MSDeploy használatával, majd webhelyeket és alkalmazáskészleteket hozhat létre vagy frissíthet.

Fontos

Ez a feladat elavult, és 2024. január 31-én megszűnik. Az IIS webalkalmazás üzembe helyezésének használata a WinRM használatával – 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.

Bevitelek

EnvironmentName - Gépek
string. Kötelező.

A gép IP-címeinek vagy teljes tartományneveinek vesszővel tagolt listáját adja meg a portokkal együtt. Az alapértelmezett port a kiválasztott protokollon alapul, például dbserver.fabrikam.com vagy dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Más feladatok kimeneti változóját is megadhatja, például $(variableName).

AdminUserName - Rendszergazda bejelentkezés
string.

Megadja a célgépek rendszergazdai bejelentkezését.

AdminPassword - Jelszó
string.

Megadja a célgépek rendszergazdai jelszavát. Képes elfogadni a build-/kiadási definíciókban definiált változókat, például $(passwordVariable): . A változótípust biztonságosként secret jelölheti meg.

WinRMProtocol - Protokoll
string. Engedélyezett értékek: Http, Https.

A gép(ek) WinRM-kapcsolatához használt protokollt adja meg. A mező alapértelmezett értéke: HTTPS.

TestCertificate - Tanúsítvány tesztelése
boolean. Választható. Használja a következőt: WinRMProtocol = Https. Alapértelmezett érték: true.

Bejelöli azt a lehetőséget, hogy kihagyja a számítógép tanúsítványának megbízható hitelesítésszolgáltató által történő érvényesítését. A paraméter a WinRM HTTPS protokollhoz szükséges.

WebDeployPackage - Webes üzembe helyezési csomag
string. Kötelező.

Megadja a Web Deploy (MSDeploy) zip-fájl helyét a célgépeken vagy egy UNC elérési úton, például: \\BudgetIT\WebDeploy\WebDeployPackage.zip. Az UNC elérési útnak elérhetőnek kell lennie a gép rendszergazdai fiókjához. A környezeti változók is támogatottak, például $env:windir, $env:systemrootés $env:windir\FabrikamFibre\Web.

WebDeployParamFile - Webes üzembe helyezési paraméterfájl
string.

Meghatározza a paraméterfájl helyét a célgépeken vagy egy UNC elérési úton. A paraméterfájl a webalkalmazás konfigurációs beállításainak felülbírálására szolgál, például az IIS-webalkalmazás neve vagy az adatbázis kapcsolati karakterlánc.

OverRideParams - Paraméterek felülbírálása
string.

Az itt megadott paraméterek felülbírálják az MSDeploy zip-fájlban és a paraméterfájlban található paramétereket. Egynél több paraméter felülbírálásához használjon vonalelválasztót.
Például "IIS Web Application Name"="Fabrikam" vagy "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Webhely létrehozása vagy frissítése
boolean. Alapértelmezett érték: false.

Megadja a webhely létrehozásának vagy egy meglévő webhely frissítésének lehetőségét.

WebSiteName - Webhely neve
string. Akkor szükséges, ha CreateWebSite = true.

Megadja annak az IIS-webhelynek a nevét, amely akkor jön létre, ha nem létezik, vagy ha már megtalálható az IIS-kiszolgálón. A webhely nevének meg kell egyeznie a webes üzembe helyezés zip-csomagfájljában megadott névvel. Ha paraméterfájl és felülbírálási paraméterek beállítása is meg van adva, akkor a webhely nevének meg kell egyeznie a felülbírálási paraméterek beállításával.

WebSitePhysicalPath - Fizikai elérési út
string. Akkor szükséges, ha CreateWebSite = true. Alapértelmezett érték: %SystemDrive%\inetpub\wwwroot.

Megadja a webhely tartalmának fizikai elérési útját. A tartalom a helyi számítógépen vagy egy távoli könyvtárban vagy megosztáson (például C:\Fabrikam vagy \\ContentShare\Fabrikam) található.

WebSitePhysicalPathAuth - Fizikai elérési út hitelesítése
string. Akkor szükséges, ha CreateWebSite = true. Engedélyezett értékek: WebSiteUserPassThrough (Alkalmazásfelhasználó (továbbítás)), WebSiteWindowsAuth (Windows-hitelesítés). Alapértelmezett érték: Application User (Pass-through).

Meghatározza a webhely fizikai elérési útjának elérésére szolgáló hitelesítési mechanizmust.

WebSiteAuthUserName - Felhasználónév
string. Akkor szükséges, ha WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Megadja a webhely fizikai elérési útjának eléréséhez szükséges felhasználónevet.

WebSiteAuthUserPassword - Jelszó
string. Választható. Használja a következőt: WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Megadja a webhely fizikai elérési útjának eléréséhez szükséges jelszót. Ha gMSA-t használ, ez nem szükséges.

AddBinding - Kötés hozzáadása
boolean. Választható. Használja a következőt: CreateWebSite = true. Alapértelmezett érték: true.

Megadja a portkötés hozzáadásának lehetőségét a webhelyhez.

AssignDuplicateBinding - Duplikált kötés hozzárendelése
boolean. Választható. Használja a következőt: AddBinding = true. Alapértelmezett érték: false.

Itt adhatja meg az itt megadott kötések hozzáadásának lehetőségét (még akkor is, ha egy másik webhely ugyanazokkal a kötésekkel). Kötési ütközések esetén csak az egyik webhely indul el.

Protocol - Protokoll
string. Akkor szükséges, ha AddBinding = true. Engedélyezett értékek: https, http. Alapértelmezett érték: http.

Megadja, hogy a webhely HTTP-kötéssel vagy HTTPS-kapcsolattal rendelkezzen a webhelyhez, és ssl-kötéssel rendelkezzen.

IPAddress - IP-cím
string. Akkor szükséges, ha AddBinding = true. Alapértelmezett érték: All Unassigned.

Megadja azt az IP-címet, amellyel a felhasználók hozzáférhetnek a webhelyhez. Ha az All Unassigned (Nincs hozzárendelve ) beállítás van kiválasztva, a webhely válaszol a porton található összes IP-címre és a helyhez megadott opcionális állomásnévre vonatkozó kérésekre. A hely nem válaszol a kérésekre, ha a kiszolgáló egy másik helyének kötése ugyanazon a porton, de egy adott IP-címmel rendelkezik.

Port - Port
string. Akkor szükséges, ha AddBinding = true. Alapértelmezett érték: 80.

Meghatározza azt a portot, amelyen a Hypertext Transfer Protocol Stacknek (HTTP.sys) figyelnie kell a webhelyre irányuló kéréseket.

ServerNameIndication - Kiszolgálónév jelzése kötelező
boolean. Választható. Használja a következőt: Protocol = https. Alapértelmezett érték: false.

Meghatározza, hogy a webhelynek szüksége van-e kiszolgálónév-jelzésre (SNI). Az SNI kiterjeszti az SSL- és TLS-protokollokat annak jelzésére, hogy az ügyfél milyen gazdagépnévhez próbál csatlakozni. Lehetővé teszi, hogy több, különböző tanúsítvánnyal rendelkező biztonságos webhely ugyanazt az IP-címet használja.

HostNameWithOutSNI - Állomásnév
string. Választható. Használja a következőt: ServerNameIndication = false.

Egy vagy több gazdagépnevet (vagy tartománynevet) rendel egy olyan számítógéphez, amely egyetlen IP-címet használ. Ha meg van adva egy gazdagépnév, az ügyfeleknek az IP-cím helyett a gazdagépnevet kell használniuk a webhely eléréséhez.

HostNameWithHttp - Állomásnév
string. Választható. Használja a következőt: Protocol = http.

Egy vagy több gazdagépnevet (vagy tartománynevet) rendel egy olyan számítógéphez, amely egyetlen IP-címet használ. Ha meg van adva egy gazdagépnév, az ügyfeleknek az IP-cím helyett a gazdagépnevet kell használniuk a webhely eléréséhez.

HostNameWithSNI - Állomásnév
string. Akkor szükséges, ha ServerNameIndication = true.

Egy vagy több gazdagépnevet (vagy tartománynevet) rendel egy olyan számítógéphez, amely egyetlen IP-címet használ. Ha meg van adva egy gazdagépnév, az ügyfeleknek az IP-cím helyett a gazdagépnevet kell használniuk a webhely eléréséhez.

SSLCertThumbPrint - SSL-tanúsítvány ujjlenyomatának nyomtatása
string. Akkor szükséges, ha Protocol = https.

Megadja a webhely által használni kívánt Secure Socket Layer-tanúsítvány ujjlenyomatát. A tanúsítványnak már telepítve kell lennie a gépen, és a Helyi számítógép személyes tárolójában kell lennie.

CreateAppPool - Alkalmazáskészlet létrehozása vagy frissítése
boolean. Alapértelmezett érték: false.

Megadja az alkalmazáskészlet létrehozásának vagy egy meglévő alkalmazáskészlet frissítésének lehetőségét.

AppPoolName - Név
string. Akkor szükséges, ha CreateAppPool = true.

Megadja a létrehozni vagy frissíteni kívánt IIS-alkalmazáskészlet nevét. A meglévő alkalmazáskészlet a megadott beállításokkal frissül.

DotNetVersion - .NET-verzió
string. Akkor szükséges, ha CreateAppPool = true. Engedélyezett értékek: v4.0, v2.0, No Managed Code. Alapértelmezett érték: v4.0.

Az alkalmazáskészlet által betöltött .NET-keretrendszer verzióját adja meg. Ha az alkalmazáskészlethez rendelt alkalmazások nem tartalmaznak felügyelt kódot, válassza a Nincs felügyelt kód lehetőséget a listából.

PipeLineMode - Felügyelt folyamat mód
string. Akkor szükséges, ha CreateAppPool = true. Engedélyezett értékek: Integrated, Classic. Alapértelmezett érték: Integrated.

A felügyelt folyamat mód azt határozza meg, hogy az IIS hogyan dolgozza fel a felügyelt tartalomra vonatkozó kéréseket. Csak akkor használjon klasszikus módot, ha az alkalmazáskészletben lévő alkalmazások nem futtathatók integrált módban.

AppPoolIdentity - Identitás
string. Akkor szükséges, ha CreateAppPool = true. Engedélyezett értékek: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkServiceSpecificUser (Egyéni fiók). Alapértelmezett érték: ApplicationPoolIdentity.

Konfigurálja azt a fiókot, amely alatt egy alkalmazáskészlet munkavégző folyamata fut. Adja meg az előre definiált biztonsági fiókok egyikét, vagy konfiguráljon egy egyéni fiókot.

AppPoolUsername - Felhasználónév
string. Akkor szükséges, ha AppPoolIdentity = SpecificUser.

AppPoolPassword - Jelszó
string. Választható. Használja a következőt: AppPoolIdentity = SpecificUser.

Ha gMSA-t használ, ez nem szükséges.

AppCmdCommands - További AppCmd.exe parancsok
string.

További AppCmd.exe parancsokat ad meg a webhely vagy az alkalmazáskészlet tulajdonságainak beállításához. Egynél több parancshoz használjon sorelválasztót.
Például:
<alkalmazáskészletek listázása>
<listawebhelyek>

DeployInParallel - Párhuzamos üzembe helyezés
boolean. Alapértelmezett érték: true.

Ha a értékre truevan állítva, a webalkalmazás párhuzamosan lesz üzembe helyezve a célgépeken.

ResourceFilteringMethod - Gépek kiválasztása a következő szerint:
string. Engedélyezett értékek: machineNames (Gépnevek), tags. Alapértelmezett érték: machineNames.

Választható. Gépnevek vagy címkék megadásával adja meg a gépek egy részhalmazát.

MachineFilter - Üzembe helyezés a gépeken
string.

Ez a bemenet csak gépcsoportokra érvényes, és még nem támogatott a gépek vagy kimeneti változók egybesimított listájában.

Megadja a gépek listáját, például dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 vagy címkéket, például Role:DB; OS:Win8.1: . Ha több címke van megadva, a feladat a megadott címkékkel rendelkező összes gépen futni fog. Az Azure-erőforráscsoportok esetében adja meg a virtuális gép nevét, például ffweb, ffdb: . Az alapértelmezett beállítás az összes gépen futtatja a feladatot.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Fontos

Ez a feladat elavult. Az IIS-webalkalmazás üzembe helyezésének használata a WinRM – Viual Studio Marketplace használatával.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.91.0 vagy újabb
Feladatkategória	Üzembe helyezés