IISWebAppDeployment@1 — задача развертывания веб-приложения IIS (не рекомендуется) версии 1

Статья
02/24/2025

Эта задача предназначена для развертывания веб-приложения IIS с помощью MSDeploy, а затем создания или обновления веб-сайтов и пулов приложений.

Важно!

Эта задача устарела и будет прекращена 31 января 2024 г. Использование развертывания веб-приложения IIS с помощью WinRM — Viual Studio Marketplace.

Важно!

Эта задача является устаревшей. Использование развертывания веб-приложения IIS с помощью WinRM — Viual Studio Marketplace.

Синтаксис

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

# IIS Web App deployment (Deprecated) v1
# Deploy by MSDeploy, create/update website & 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.

Входные данные

EnvironmentName - Машины
string. Обязательный.

Указывает разделенный запятыми список IP-адресов или полных доменных имен компьютеров, а также порты. Порт по умолчанию основан на выбранном протоколе, например dbserver.fabrikam.com или dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Можно также указать выходную переменную других задач, например $(variableName).

AdminUserName - Вход Администратор
string.

Указывает имя входа администратора для целевых компьютеров.

AdminPassword - Пароль
string.

Указывает пароль администратора для целевых компьютеров. Он может принимать переменные, определенные в определениях сборки и выпуска, например $(passwordVariable). Вы можете пометить тип переменной как secret безопасный.

WinRMProtocol - Протокол
string. Допустимые значения: Http, Https.

Указывает протокол, используемый для подключения WinRM к компьютерам. Значение по умолчанию — HTTPS.

TestCertificate - Тестовый сертификат
boolean. Необязательный элемент. Используйте при WinRMProtocol = Https. Значение по умолчанию: true.

Выбирает параметр пропуска проверки подлинности сертификата компьютера доверенным центром сертификации. Параметр является обязательным для протокола WinRM HTTPS .

WebDeployPackage - Пакет веб-развертывания
string. Обязательный.

Указывает расположение ZIP-файла веб-развертывания (MSDeploy) на целевых компьютерах или по UNC-пути, \\BudgetIT\WebDeploy\WebDeployPackage.zipнапример . UNC-путь должен быть доступен для учетной записи администратора компьютера. Также поддерживаются переменные среды, такие как $env:windir, $env:systemrootи $env:windir\FabrikamFibre\Web.

WebDeployParamFile - Файл параметров веб-развертывания
string.

Указывает расположение файла параметров на целевых компьютерах или по UNC-пути. Файл параметров используется для переопределения параметров конфигурации веб-приложения, таких как имя веб-приложения IIS или строка подключения базы данных.

OverRideParams - Переопределение параметров
string.

Указанные здесь параметры переопределяют параметры в ZIP-файле MSDeploy и файле параметров. Чтобы переопределить несколько параметров, используйте разделитель строк.
Например, "IIS Web Application Name"="Fabrikam" или "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - Создание или обновление веб-сайта
boolean. Значение по умолчанию: false.

Задает параметр для создания веб-сайта или обновления существующего веб-сайта.

WebSiteName - Имя веб-сайта
string. Требуется при .CreateWebSite = true

Указывает имя веб-сайта IIS, который будет создан, если он не существует, или обновляется, если он уже присутствует на сервере IIS. Имя веб-сайта должно совпадать с именем, указанным в ZIP-файле веб-развертывания. Если также указан файл параметров и параметр переопределения параметров, имя веб-сайта должно совпадать с именем в параметре переопределения параметров.

WebSitePhysicalPath - Физический путь
string. Требуется при .CreateWebSite = true Значение по умолчанию: %SystemDrive%\inetpub\wwwroot.

Указывает физический путь, по которому хранится содержимое веб-сайта. Содержимое может находиться на локальном компьютере, в удаленном каталоге или в общем ресурсе, например C:\Fabrikam или \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - Проверка подлинности физического пути
string. Требуется при .CreateWebSite = true Допустимые значения: WebSiteUserPassThrough (пользователь приложения (сквозная передача)), WebSiteWindowsAuth (проверка подлинности Windows). Значение по умолчанию: Application User (Pass-through).

Указывает механизм проверки подлинности для доступа к физическому пути веб-сайта.

WebSiteAuthUserName - Имя пользователя
string. Требуется при .WebSitePhysicalPathAuth = WebSiteWindowsAuth

Указывает имя пользователя для доступа к физическому пути веб-сайта.

WebSiteAuthUserPassword - Пароль
string. Необязательный элемент. Используйте при WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Указывает пароль для доступа к физическому пути веб-сайта. Если вы используете gMSA, это необязательно.

AddBinding - Добавление привязки
boolean. Необязательный элемент. Используйте при CreateWebSite = true. Значение по умолчанию: true.

Задает параметр для добавления привязки порта для веб-сайта.

AssignDuplicateBinding - Назначение повторяющейся привязки
boolean. Необязательный элемент. Используйте при AddBinding = true. Значение по умолчанию: false.

Задает параметр для добавления указанных здесь привязок (даже если есть другой веб-сайт с теми же привязками). При наличии конфликтов привязки запускается только один из веб-сайтов.

Protocol - Протокол
string. Требуется при .AddBinding = true Допустимые значения: https, http. Значение по умолчанию: http.

Указывает http для веб-сайта, который должен иметь привязку HTTP, или HTTPS для веб-сайта, чтобы иметь привязку SSL.

IPAddress - IP-адрес
string. Требуется при .AddBinding = true Значение по умолчанию: All Unassigned.

Указывает IP-адрес, который пользователи могут использовать для доступа к веб-сайту. Если выбран параметр Все неназначенные , сайт будет отвечать на запросы для всех IP-адресов в порту и дополнительного имени узла, указанного для сайта. Сайт не будет отвечать на запросы, если другой сайт на сервере имеет привязку к тому же порту, но с определенным IP-адресом.

Port - Порт
string. Требуется при .AddBinding = true Значение по умолчанию: 80.

Указывает порт, на котором стек протокола передачи гипертекста (HTTP.sys) должен отслеживать запросы на этот веб-сайт.

ServerNameIndication - Требуется указание имени сервера
boolean. Необязательный элемент. Используйте при Protocol = https. Значение по умолчанию: false.

Определяет, требуется ли указание имени сервера (SNI) для веб-сайта. SNI расширяет протоколы SSL и TLS, чтобы указать имя узла, к которому клиент пытается подключиться. Это позволяет использовать одинаковый IP-адрес на нескольких безопасных веб-сайтах с разными сертификатами.

HostNameWithOutSNI - Имя узла
string. Необязательный элемент. Используйте при ServerNameIndication = false.

Назначает одно или несколько имен узлов (или доменных имен) компьютеру, использующему один IP-адрес. Если указано имя узла, клиенты должны использовать имя узла вместо IP-адреса для доступа к веб-сайту.

HostNameWithHttp - Имя узла
string. Необязательный элемент. Используйте при Protocol = http.

HostNameWithSNI - Имя узла
string. Требуется, если ServerNameIndication = true.

SSLCertThumbPrint - Печать большого пальца SSL-сертификата
string. Требуется, если Protocol = https.

Указывает большой отпечаток сертификата secure Socket Layer, который будет использоваться веб-сайтом. Сертификат уже должен быть установлен на компьютере и находиться в личном хранилище локального компьютера.

CreateAppPool - Создание или обновление пула приложений
boolean. Значение по умолчанию: false.

Указывает параметр для создания пула приложений или обновления существующего пула приложений.

AppPoolName - Имя
string. Требуется, если CreateAppPool = true.

Указывает имя создаваемого или обновляемого пула приложений IIS. Существующий пул приложений будет обновлен с учетом указанных параметров.

DotNetVersion - Версия .NET
string. Требуется, если CreateAppPool = true. Допустимые значения: v4.0, v2.0, No Managed Code. Значение по умолчанию: v4.0.

Указывает версию платформа .NET Framework, загруженную этим пулом приложений. Если приложения, назначенные этому пулу приложений, не содержат управляемый код, выберите в списке параметр Без управляемого кода .

PipeLineMode - Режим управляемого конвейера
string. Требуется, если CreateAppPool = true. Допустимые значения: Integrated, Classic. Значение по умолчанию: Integrated.

Режим управляемого конвейера указывает, как СЛУЖБЫ IIS обрабатывают запросы на управляемое содержимое. Используйте классический режим, только если приложения в пуле приложений не могут работать в интегрированном режиме.

AppPoolIdentity - Идентичности
string. Требуется, если CreateAppPool = true. Допустимые значения: ApplicationPoolIdentity, LocalService, LocalSystem, SpecificUserNetworkService(пользовательская учетная запись). Значение по умолчанию: ApplicationPoolIdentity.

Настраивает учетную запись, с которой выполняется рабочий процесс пула приложений. Укажите одну из предопределенных учетных записей безопасности или настройте пользовательскую учетную запись.

AppPoolUsername - Пользователя
string. Требуется, если AppPoolIdentity = SpecificUser.

AppPoolPassword - Пароль
string. Необязательный элемент. Используйте при AppPoolIdentity = SpecificUser.

Если вы используете gMSA, это необязательно.

AppCmdCommands - Дополнительные команды AppCmd.exe
string.

Указывает дополнительные AppCmd.exe команды для задания свойств веб-сайта или пула приложений. Для нескольких команд используйте разделитель строк.
Пример:
<перечисление пулов приложений>
<список сайтов>

DeployInParallel - Параллельное развертывание
boolean. Значение по умолчанию: true.

Если задано значение true, веб-приложение развертывается параллельно на целевых компьютерах.

ResourceFilteringMethod - Выбор компьютеров по
string. Допустимые значения: machineNames (имена компьютеров), tags. Значение по умолчанию: machineNames.

Необязательный элемент. Указывает подмножество компьютеров, предоставляя имена компьютеров или теги.

MachineFilter - Развертывание на компьютерах
string.

Эти входные данные допустимы только для групп компьютеров и пока не поддерживаются для неструктурированного списка компьютеров или выходных переменных.

Указывает список компьютеров, например dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 или тегов, например Role:DB; OS:Win8.1. Если указано несколько тегов, задача будет выполняться на всех компьютерах с указанными тегами. В поле Группы ресурсов Azure укажите имя виртуальной машины, например ffweb, ffdb. По умолчанию задача выполняется на всех компьютерах.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Важно!

Эта задача является устаревшей. Используйте развертывание веб-приложения IIS с помощью WinRM — Viual Studio Marketplace.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Нет
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	1.91.0 или более поздней версии
Категория задач	Развертывание

Поделиться через

IISWebAppDeployment@1 — задача развертывания веб-приложения IIS (не рекомендуется) версии 1

Синтаксис

Входные данные

Параметры управления задачами

Выходные переменные

Remarks

Требования

Обратная связь

Дополнительные ресурсы