модуль microsoft.iis.web_application — настройка веб-приложений IIS

Примечание

Этот модуль входит в коллекцию microsoft.iis (версия 1.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install microsoft.iis. Для использования этого модуля могут потребоваться дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: microsoft.iis.web_application.

Краткое описание
Требования
Параметры
Атрибуты
См. также
Примеры

Краткое описание

Создаёт, удаляет и настраивает веб-приложения IIS.

Требования

Перечисленные ниже компоненты должны быть установлены на узле, на котором выполняется этот модуль.

Модуль PowerShell IISAdministration

Параметры

Параметр	Комментарии
application_pool строка	Пул приложений, в котором выполняется новый сайт. Если не указано, будет использоваться пул приложений текущего веб-сайта.
connect_as строка	Тип аутентификации, используемый для этого приложения: `pass_through` или `specific_user`. Если указано `pass_through`, IIS будет использовать удостоверение пользователя или удостоверение пула приложений для доступа к файловой системе или сети. Если указано `specific_user`, IIS будет использовать учётные данные, указанные в `username` и `password`, для доступа к файловой системе или сети. Если параметр не указан, по умолчанию используется `pass_through`, а существующее приложение не изменяется. Варианты: `"pass_through"` `"specific_user"`
name строка / обязательный	Имя веб-приложения.
password строка	Пароль, связанный с `username`. Обязателен, если указано `connect_as=specific_user`.
physical_path псевдонимы: path строка	Физический путь на удалённом узле, используемый для нового приложения. Указанная папка должна уже существовать.
site строка / обязательный	Имя сайта, на котором создаётся приложение.
state строка	Состояние веб-приложения. Если указано `absent`, веб-приложение будет удалено. Если указано `present`, веб-приложение будет создано, если оно ещё не существует. Варианты: `"absent"` `"present"` ← (по умолчанию)
username строка	Имя пользователя учётной записи, имеющей доступ к файлам конфигурации и содержимому этого приложения. Обязательно, если указано `connect_as=specific_user`.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния без изменения целевого узла. Если режим не поддерживается, действие будет пропущено.
diff_mode	Поддержка: нет	В режиме diff будет возвращена информация о внесённых изменениях (или о возможных изменениях в режиме check_mode).
platform	Платформа: windows	Целевые ОС и семейства ОС, с которыми можно работать.

См. также

microsoft.iis.web_application_info: Получение информации о веб-приложениях IIS.
microsoft.iis.web_app_pool: Настройка пулов веб-приложений IIS.
microsoft.iis.website: Настройка веб-сайта IIS.

Примеры

- name: Add ACME web application on IIS
  microsoft.iis.web_application:
    name: api
    site: acme
    state: present
    physical_path: C:\apps\acme\api

- name: Change connect_as to be specific user
  microsoft.iis.web_application:
    name: api
    site: acme
    connect_as: specific_user
    username: acmeuser
    password: acmepassword

- name: Delete ACME web application on IIS
  microsoft.iis.web_application:
    state: absent
    name: api
    site: acme

Авторы

Henrik Wallström (@henrikwallstrom)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/microsoft/iis/web_application_module.html