IISWebAppDeployment@1 – úloha nasazení webové aplikace iis (zastaralé) verze 1

Pomocí této úlohy nasadíte webovou aplikaci služby IIS pomocí msDeploy a pak vytvoříte nebo aktualizujete weby a fondy aplikací.

Důležité

Tento úkol je zastaralý a bude vyřazen 31. ledna 2024. Použití nasazení webové aplikace iis pomocí 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.

Vstupy

EnvironmentName - Stroje
string. Povinná hodnota.

Určuje čárkami oddělený seznam IP adres počítačů nebo plně kvalifikovaných názvů domén spolu s porty. Výchozí port je založený na vybraném protokolu, například dbserver.fabrikam.com nebo dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Můžete také zadat výstupní proměnnou jiných úkolů, například $(variableName).

AdminUserName - přihlášení Správa
string.

Určuje přihlášení správce pro cílové počítače.

AdminPassword - Heslo
string.

Určuje heslo správce pro cílové počítače. Může přijímat proměnné definované v definicích sestavení/vydané verze, například $(passwordVariable). Typ proměnné můžete označit jako secret zabezpečený.

WinRMProtocol - Protokol
string. Povolené hodnoty: Http, Https.

Určuje protokol používaný pro připojení WinRM k počítačům. Výchozí formát je HTTPS.

TestCertificate - Test certifikátu
boolean. Nepovinný parametr. Použijte, když WinRMProtocol = Https. Výchozí hodnota: true.

Vybere možnost přeskočit ověřování pravosti certifikátu počítače důvěryhodnou certifikační autoritou. Parametr je vyžadován pro protokol WinRM HTTPS .

WebDeployPackage - Balíček pro nasazení webu
string. Povinná hodnota.

Určuje umístění souboru ZIP nasazení webu (MSDeploy) na cílových počítačích nebo v cestě UNC, \\BudgetIT\WebDeploy\WebDeployPackage.zipnapříklad . Cesta UNC by měla být přístupná pro účet správce počítače. Podporují se také proměnné prostředí, jako jsou $env:windir, $env:systemroota $env:windir\FabrikamFibre\Web.

WebDeployParamFile - Soubor parametrů nasazení webu
string.

Určuje umístění souboru parametrů na cílových počítačích nebo v cestě UNC. Soubor parametrů slouží k přepsání nastavení konfigurace webové aplikace, jako je název webové aplikace služby IIS nebo připojovací řetězec databáze.

OverRideParams - Přepsat parametry
string.

Zde zadané parametry přepíší parametry v souboru ZIP MSDeploy a souboru parametrů. Pokud chcete přepsat více než jeden parametr, použijte oddělovač řádků.
Příkladem je "IIS Web Application Name"="Fabrikam" nebo "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Vytvoření nebo aktualizace webu
boolean. Výchozí hodnota: false.

Určuje možnost vytvořit web nebo aktualizovat existující web.

WebSiteName - Název webu
string. Vyžaduje se, když CreateWebSite = true.

Určuje název webu služby IIS, který bude vytvořen, pokud neexistuje, nebo se aktualizuje, pokud již existuje na serveru služby IIS. Název webu by měl být stejný jako název zadaný v souboru balíčku ZIP pro nasazení webu. Pokud je zadaný také soubor parametrů a nastavení parametrů přepsání, měl by být název webu stejný jako název v nastavení parametrů přepsání.

WebSitePhysicalPath - Fyzická cesta
string. Vyžaduje se, když CreateWebSite = true. Výchozí hodnota: %SystemDrive%\inetpub\wwwroot.

Určuje fyzickou cestu, kam je uložen obsah webu. Obsah se může nacházet v místním počítači nebo ve vzdáleném adresáři nebo sdílené složce, například C:\Fabrikam nebo \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Ověřování fyzické cesty
string. Vyžaduje se, když CreateWebSite = true. Povolené hodnoty: WebSiteUserPassThrough (Uživatel aplikace (předávací)), WebSiteWindowsAuth (Ověřování systému Windows). Výchozí hodnota: Application User (Pass-through).

Určuje mechanismus ověřování pro přístup k fyzické cestě webu.

WebSiteAuthUserName - Uživatelské jméno
string. Vyžaduje se, když WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Určuje uživatelské jméno pro přístup k fyzické cestě webu.

WebSiteAuthUserPassword - Heslo
string. Nepovinný parametr. Použijte, když WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Určuje heslo pro přístup k fyzické cestě webu. Pokud používáte gMSA, není to nutné.

AddBinding - Přidat vazbu
boolean. Nepovinný parametr. Použijte, když CreateWebSite = true. Výchozí hodnota: true.

Určuje možnost pro přidání vazby portu pro web.

AssignDuplicateBinding - Přiřadit duplicitní vazbu
boolean. Nepovinný parametr. Použijte, když AddBinding = true. Výchozí hodnota: false.

Určuje možnost přidat zde zadané vazby (i když existuje jiný web se stejnými vazbami). Pokud dojde ke konfliktům vazby, spustí se jenom jeden z webů.

Protocol - Protokol
string. Vyžaduje se, když AddBinding = true. Povolené hodnoty: https, http. Výchozí hodnota: http.

Určuje buď HTTP, aby web měl vazbu HTTP, nebo HTTPS, aby web měl vazbu SSL (Secure Sockets Layer).

IPAddress - IP adresa
string. Vyžaduje se, když AddBinding = true. Výchozí hodnota: All Unassigned.

Určuje IP adresu, kterou můžou uživatelé použít pro přístup k webu. Pokud je vybrána možnost Vše nepřiřazeno , bude lokalita reagovat na požadavky na všechny IP adresy na portu a volitelný název hostitele, který je pro lokalitu zadaný. Web nebude reagovat na požadavky, pokud má jiná lokalita na serveru vazbu na stejném portu, ale s konkrétní IP adresou.

Port - Port
string. Vyžaduje se, když AddBinding = true. Výchozí hodnota: 80.

Určuje port, na kterém musí zásobník protokolu HTTP.sys (Hypertext Transfer Protocol) monitorovat požadavky na tento web.

ServerNameIndication - Indikace názvu serveru je povinná.
boolean. Nepovinný parametr. Použijte, když Protocol = https. Výchozí hodnota: false.

Určuje, jestli web vyžaduje indikaci názvu serveru (SNI). SNI rozšiřuje protokoly SSL a TLS o název hostitele, ke kterému se klient pokouší připojit. Umožňuje více zabezpečeným webům s různými certifikáty používat stejnou IP adresu.

HostNameWithOutSNI - Název hostitele
string. Nepovinný parametr. Použijte, když ServerNameIndication = false.

Přiřadí jeden nebo více názvů hostitelů (nebo názvů domén) počítači, který používá jednu IP adresu. Pokud je zadán název hostitele, klienti musí pro přístup k webu používat název hostitele místo IP adresy.

HostNameWithHttp - Název hostitele
string. Nepovinný parametr. Použijte, když Protocol = http.

Přiřadí jeden nebo více názvů hostitelů (nebo názvů domén) počítači, který používá jednu IP adresu. Pokud je zadán název hostitele, klienti musí pro přístup k webu používat název hostitele místo IP adresy.

HostNameWithSNI - Název hostitele
string. Vyžaduje se, když ServerNameIndication = true.

Přiřadí jeden nebo více názvů hostitelů (nebo názvů domén) počítači, který používá jednu IP adresu. Pokud je zadán název hostitele, klienti musí pro přístup k webu používat název hostitele místo IP adresy.

SSLCertThumbPrint - Kryptografický otisk certifikátu SSL
string. Vyžaduje se, když Protocol = https.

Určuje kryptografický otisk certifikátu Secure Socket Layer, který bude web používat. Certifikát by už měl být na počítači nainstalovaný a měl by být v úložišti Osobní místní počítač.

CreateAppPool - Vytvoření nebo aktualizace fondu aplikací
boolean. Výchozí hodnota: false.

Určuje možnost vytvořit fond aplikací nebo aktualizovat existující fond aplikací.

AppPoolName - Jméno
string. Vyžaduje se, když CreateAppPool = true.

Určuje název fondu aplikací služby IIS, který se má vytvořit nebo aktualizovat. Existující fond aplikací se aktualizuje se zadaným nastavením.

DotNetVersion - Verze .NET
string. Vyžaduje se, když CreateAppPool = true. Povolené hodnoty: v4.0, v2.0, No Managed Code. Výchozí hodnota: v4.0.

Určuje verzi rozhraní .NET Framework načtenou tímto fondem aplikací. Pokud aplikace přiřazené k tomuto fondu aplikací neobsahují spravovaný kód, vyberte ze seznamu možnost Žádný spravovaný kód .

PipeLineMode - Režim spravovaného kanálu
string. Vyžaduje se, když CreateAppPool = true. Povolené hodnoty: Integrated, Classic. Výchozí hodnota: Integrated.

Režim spravovaného kanálu určuje, jak služba IIS zpracovává požadavky na spravovaný obsah. Klasický režim používejte pouze v případě, že aplikace ve fondu aplikací nelze spustit v integrovaném režimu.

AppPoolIdentity - Identity
string. Vyžaduje se, když CreateAppPool = true. Povolené hodnoty: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, ( SpecificUser Vlastní účet). Výchozí hodnota: ApplicationPoolIdentity.

Nakonfiguruje účet, pod kterým běží pracovní proces fondu aplikací. Zadejte jeden z předdefinovaných účtů zabezpečení nebo nakonfigurujte vlastní účet.

AppPoolUsername - Username
string. Vyžaduje se, když AppPoolIdentity = SpecificUser.

AppPoolPassword - Heslo
string. Nepovinný parametr. Použijte, když AppPoolIdentity = SpecificUser.

Pokud používáte gMSA, není to nutné.

AppCmdCommands - Další příkazy AppCmd.exe
string.

Určuje další AppCmd.exe příkazy pro nastavení vlastností webu nebo fondu aplikací. Pro více než jeden příkaz použijte oddělovač řádků.
Příklad:
<Výpis fondů aplikací>
<seznam webů>

DeployInParallel - Paralelní nasazení
boolean. Výchozí hodnota: true.

Pokud je nastavená hodnota true, webová aplikace se nasadí paralelně na cílových počítačích.

ResourceFilteringMethod - Vybrat počítače podle
string. Povolené hodnoty: machineNames (názvy počítačů), tags. Výchozí hodnota: machineNames.

Nepovinný parametr. Určuje podmnožinu počítačů zadáním názvů počítačů nebo značek.

MachineFilter - Nasazení do počítačů
string.

Tento vstup je platný pouze pro skupiny počítačů a zatím není podporován pro plochý seznam počítačů ani výstupních proměnných.

Určuje seznam počítačů, například dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 nebo značek, například Role:DB; OS:Win8.1. Pokud je zadáno více značek, úloha se spustí ve všech počítačích se zadanými značkami. V části Skupiny prostředků Azure zadejte název virtuálního počítače, například ffweb, ffdb. Ve výchozím nastavení se úloha spouští na všech počítačích.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Důležité

Tato úloha je zastaralá. Použití nasazení webové aplikace iis pomocí WinRM – Viual Studio Marketplace.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.91.0 nebo vyšší
Kategorie úloh	Nasazení