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

Статья
03/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.

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

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.

IP-адрес IPAddress -
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, загруженную этим пулом приложений. Если приложения, назначенные этому пулу приложений, не содержат управляемый код, выберите параметр No Managed Code из списка.

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

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

удостоверения AppPoolIdentity -
string. Требуется, если CreateAppPool = true. Допустимые значения: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (пользовательская учетная запись). Значение по умолчанию: 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. По умолчанию задача выполняется на всех компьютерах.

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

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

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

Нет.

Замечания

Это важно

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

Требования

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

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

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

Синтаксис

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

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

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

Замечания

Требования

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

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