IISWebAppDeployment@1 — zadanie wdrażania aplikacji internetowej usług IIS (przestarzałe) w wersji 1

Użyj tego zadania, aby wdrożyć aplikację internetową usług IIS przy użyciu narzędzia MSDeploy, a następnie utworzyć lub zaktualizować witryny internetowe i pule aplikacji.

Ważne

To zadanie jest przestarzałe i zostanie wycofane 31 stycznia 2024 r. Wdrażanie aplikacji internetowej usług IIS przy użyciu usługi WinRM — Viual Studio Marketplace.

Składnia

# 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.

Dane wejściowe

EnvironmentName - Maszyny
string. Wymagane.

Określa rozdzielaną przecinkami listę adresów IP maszyny lub nazw FQDN wraz z portami. Port domyślny jest oparty na wybranym protokole, na przykład dbserver.fabrikam.com lub dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Możesz również podać zmienną wyjściową innych zadań, na przykład $(variableName).

AdminUserName - logowanie Administracja
string.

Określa identyfikator logowania administratora dla maszyn docelowych.

AdminPassword - Hasło
string.

Określa hasło administratora dla maszyn docelowych. Może akceptować zmienne zdefiniowane w definicjach kompilacji/wydania, takich jak $(passwordVariable). Możesz oznaczyć typ zmiennej tak secret , aby go zabezpieczyć.

WinRMProtocol - Protokół
string. Dozwolone wartości: Http, Https.

Określa protokół używany do połączenia Usługi WinRM z maszynami. Wartość domyślna to HTTPS.

TestCertificate - Certyfikat testowy
boolean. Opcjonalny. Użyj polecenia , gdy WinRMProtocol = Https. Wartość domyślna: true.

Wybiera opcję pomijania weryfikacji autentyczności certyfikatu maszyny przez zaufany urząd certyfikacji. Parametr jest wymagany dla protokołu WinRM HTTPS .

WebDeployPackage - Pakiet Web Deploy
string. Wymagane.

Określa lokalizację pliku zip web deploy (MSDeploy) na maszynach docelowych lub w ścieżce UNC, \\BudgetIT\WebDeploy\WebDeployPackage.ziptakiej jak . Ścieżka UNC powinna być dostępna dla konta administratora komputera. Zmienne środowiskowe są również obsługiwane, takie jak $env:windir, $env:systemrooti $env:windir\FabrikamFibre\Web.

WebDeployParamFile - Plik parametrów web deploy
string.

Określa lokalizację pliku parametrów na maszynach docelowych lub w ścieżce UNC. Plik parametrów służy do zastępowania ustawień konfiguracji aplikacji internetowej, takich jak nazwa aplikacji internetowej usług IIS lub parametry połączenia bazy danych.

OverRideParams - Zastępowanie parametrów
string.

Parametry określone tutaj zastąpią parametry w pliku zip MSDeploy i pliku parametrów. Aby zastąpić więcej niż jeden parametr, użyj separatora linii.
Na przykład: "IIS Web Application Name"="Fabrikam" lub "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Tworzenie lub aktualizowanie witryny sieci Web
boolean. Wartość domyślna: false.

Określa opcję utworzenia witryny internetowej lub zaktualizowania istniejącej witryny internetowej.

WebSiteName - Nazwa witryny internetowej
string. Wymagane, gdy CreateWebSite = true.

Określa nazwę witryny sieci Web usług IIS, która zostanie utworzona, jeśli nie istnieje lub zostanie zaktualizowana, jeśli jest już obecna na serwerze usług IIS. Nazwa witryny sieci Web powinna być taka sama jak określona w pliku pakietu zip wdrożenia internetowego. Jeśli określono również ustawienie parametrów pliku parametrów i przesłonięcia, nazwa witryny internetowej powinna być taka sama jak w ustawieniu przesłonięć parametrów.

WebSitePhysicalPath - Ścieżka fizyczna
string. Wymagane, gdy CreateWebSite = true. Wartość domyślna: %SystemDrive%\inetpub\wwwroot.

Określa ścieżkę fizyczną, w której jest przechowywana zawartość witryny internetowej. Zawartość może znajdować się na komputerze lokalnym lub w katalogu zdalnym lub w udziale, na przykład C:\Fabrikam lub \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Uwierzytelnianie ścieżki fizycznej
string. Wymagane, gdy CreateWebSite = true. Dozwolone wartości: WebSiteUserPassThrough (Użytkownik aplikacji (przekazywanie)), WebSiteWindowsAuth (Uwierzytelnianie systemu Windows). Wartość domyślna: Application User (Pass-through).

Określa mechanizm uwierzytelniania umożliwiający dostęp do ścieżki fizycznej witryny internetowej.

WebSiteAuthUserName - Nazwa użytkownika
string. Wymagane, gdy WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Określa nazwę użytkownika na potrzeby uzyskiwania dostępu do ścieżki fizycznej witryny internetowej.

WebSiteAuthUserPassword - Hasło
string. Opcjonalny. Użyj polecenia , gdy WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Określa hasło dostępu do ścieżki fizycznej witryny internetowej. Jeśli używasz konta gMSA, nie jest to wymagane.

AddBinding - Dodawanie powiązania
boolean. Opcjonalny. Użyj polecenia , gdy CreateWebSite = true. Wartość domyślna: true.

Określa opcję dodawania powiązania portów dla witryny internetowej.

AssignDuplicateBinding - Przypisywanie zduplikowanego powiązania
boolean. Opcjonalny. Użyj polecenia , gdy AddBinding = true. Wartość domyślna: false.

Określa opcję dodawania powiązań określonych tutaj (nawet jeśli istnieje inna witryna internetowa z tymi samymi powiązaniami). Jeśli występują konflikty powiązań, rozpocznie się tylko jedna z witryn internetowych.

Protocol - Protokół
string. Wymagane, gdy AddBinding = true. Dozwolone wartości: https, http. Wartość domyślna: http.

Określa protokół HTTP dla witryny internetowej, aby mieć powiązanie HTTP lub HTTPS, aby witryna internetowa miała powiązanie Secure Sockets Layer (SSL).

IPAddress - Adres IP
string. Wymagane, gdy AddBinding = true. Wartość domyślna: All Unassigned.

Określa adres IP, którego użytkownicy mogą używać do uzyskiwania dostępu do witryny internetowej. Jeśli wybrano opcję Wszystkie nieprzypisane , lokacja będzie odpowiadać na żądania wszystkich adresów IP na porcie i opcjonalną nazwę hosta określoną dla lokacji. Lokacja nie odpowie na żądania, jeśli inna lokacja na serwerze ma powiązanie na tym samym porcie, ale z określonym adresem IP.

Port - Portu
string. Wymagane, gdy AddBinding = true. Wartość domyślna: 80.

Określa port, na którym musi być monitorowany stos protokołu transferu hipertekstowego (HTTP.sys) dla żądań wysyłanych do tej witryny internetowej.

ServerNameIndication - Wymagane wskazanie nazwy serwera
boolean. Opcjonalny. Użyj polecenia , gdy Protocol = https. Wartość domyślna: false.

Określa, czy witryna internetowa wymaga wskazania nazwy serwera (SNI). SNI rozszerza protokoły SSL i TLS, aby wskazać, z jaką nazwą hosta klient próbuje nawiązać połączenie. Umożliwia wielu bezpiecznym witrynom internetowym z różnymi certyfikatami używanie tego samego adresu IP.

HostNameWithOutSNI - Nazwa hosta
string. Opcjonalny. Użyj polecenia , gdy ServerNameIndication = false.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli zostanie określona nazwa hosta, klienci muszą użyć nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.

HostNameWithHttp - Nazwa hosta
string. Opcjonalny. Użyj polecenia , gdy Protocol = http.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli zostanie określona nazwa hosta, klienci muszą użyć nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.

HostNameWithSNI - Nazwa hosta
string. Wymagane, gdy ServerNameIndication = true.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli zostanie określona nazwa hosta, klienci muszą użyć nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.

SSLCertThumbPrint - Drukowanie odcisku palca certyfikatu SSL
string. Wymagane, gdy Protocol = https.

Określa odcisk palca certyfikatu Secure Socket Layer, którego będzie używać witryna internetowa. Certyfikat powinien być już zainstalowany na komputerze i znajdujący się w magazynie osobistym komputera lokalnego.

CreateAppPool - Tworzenie lub aktualizowanie puli aplikacji
boolean. Wartość domyślna: false.

Określa opcję utworzenia puli aplikacji lub zaktualizowania istniejącej puli aplikacji.

AppPoolName - Nazwa
string. Wymagane, gdy CreateAppPool = true.

Określa nazwę puli aplikacji usług IIS do utworzenia lub zaktualizowania. Istniejąca pula aplikacji zostanie zaktualizowana przy użyciu określonych ustawień.

DotNetVersion - Wersja platformy .NET
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: v4.0, , No Managed Codev2.0. Wartość domyślna: v4.0.

Określa wersję .NET Framework ładowaną przez tę pulę aplikacji. Jeśli aplikacje przypisane do tej puli aplikacji nie zawierają kodu zarządzanego, wybierz opcję Brak kodu zarządzanego z listy.

PipeLineMode - Tryb zarządzanego potoku
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: Integrated, Classic. Wartość domyślna: Integrated.

Tryb zarządzanego potoku określa, jak usługi IIS przetwarzają żądania dotyczące zawartości zarządzanej. Używaj trybu klasycznego tylko wtedy, gdy aplikacje w puli aplikacji nie mogą działać w trybie zintegrowanym.

AppPoolIdentity - Tożsamości
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: ApplicationPoolIdentity, , LocalSystemLocalService, NetworkService, SpecificUser (konto niestandardowe). Wartość domyślna: ApplicationPoolIdentity.

Konfiguruje konto, na którym jest uruchamiany proces roboczy puli aplikacji. Określ jedno ze wstępnie zdefiniowanych kont zabezpieczeń lub skonfiguruj konto niestandardowe.

AppPoolUsername - Nazwę użytkownika
string. Wymagane, gdy AppPoolIdentity = SpecificUser.

AppPoolPassword - Hasło
string. Opcjonalny. Użyj polecenia , gdy AppPoolIdentity = SpecificUser.

Jeśli używasz konta gMSA, nie jest to wymagane.

AppCmdCommands - Dodatkowe polecenia AppCmd.exe
string.

Określa dodatkowe AppCmd.exe polecenia, aby ustawić właściwości witryny internetowej lub puli aplikacji. W przypadku więcej niż jednego polecenia użyj separatora wiersza.
Na przykład:
<wyświetlanie listy pul aplikacji>
<listy witryn>

DeployInParallel - Wdrażanie równolegle
boolean. Wartość domyślna: true.

Jeśli ustawiono wartość true, aplikacja internetowa jest wdrażana równolegle na maszynach docelowych.

ResourceFilteringMethod - Wybieranie maszyn według
string. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Opcjonalny. Określa podzestaw maszyn, podając nazwy maszyn lub tagi.

MachineFilter - Wdrażanie na maszynach
string.

Te dane wejściowe są prawidłowe tylko dla grup maszyn i nie są jeszcze obsługiwane w przypadku płaskiej listy maszyn lub zmiennych wyjściowych.

Określa listę maszyn, takich jak dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 lub tagi, na przykład Role:DB; OS:Win8.1. Jeśli podano wiele tagów, zadanie zostanie uruchomione na wszystkich maszynach z określonymi tagami. W obszarze Grupy zasobów platformy Azure określ nazwę maszyny wirtualnej, na przykład ffweb, ffdb. Wartość domyślna uruchamia zadanie na wszystkich maszynach.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Ważne

To zadanie jest przestarzałe. Wdrażanie aplikacji internetowej usług IIS przy użyciu usługi WinRM — Viual Studio Marketplace.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.91.0 lub nowszy
Kategoria zadania	Wdrażanie