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

Примечание

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

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

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

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

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

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

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

Требования

Следующие компоненты необходимы на узле, на котором выполняется этот модуль.

Модуль PowerShell IISAdministration

Параметры

Параметр	Комментарии
attributes словарь	Это поле представляет собой словарь произвольной структуры со значениями атрибутов пула приложений. Названия этих атрибутов соответствуют стандарту, описанному на странице https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005. Подробнее о том, как их задавать, см. в разделе с примерами. Можно также задавать атрибуты дочерних элементов, например cpu и processModel. Примеры показывают, как это сделать. Для перечислений можно использовать числовые значения, но рекомендуется указывать сами имена элементов перечисления. Например, для processModel.identityType используйте SpecificUser вместо 3. Значением managedPipelineMode может быть “Integrated” или “Classic”. Значением startMode может быть “OnDemand” или “AlwaysRunning”. Для изменения состояния пула приложений используйте `state`. Если при попытке задать `processModel.password` возникает ошибка «Значение выходит за пределы ожидаемого диапазона», значит, хранилище ключей повреждено. Чтобы исправить проблему на узле, следуйте инструкциям на странице http://structuredsight.com/2014/10/26/im-out-of-range-youre-out-of-range/. По умолчанию: `{}`
name строка / обязательный	Имя пула приложений.
state строка	Состояние пула приложений. Если задано `absent`, пул приложений будет удалён. Если задано `present`, пул приложений будет настроен и создан. Если задано `restarted`, пул приложений будет создан и перезапущен. Это действие не является идемпотентным. Если задано `started`, пул приложений будет создан и запущен. Если задано `stopped`, пул приложений будет создан и остановлен. Допустимые значения: `"absent"` `"present"` ← (по умолчанию) `"restarted"` `"started"` `"stopped"`

Атрибуты

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

См. также

microsoft.iis.web_app_pool_info: Получение сведений о пулах веб-приложений IIS.

Примеры

- name: Create a new application pool in 'Started' state
  microsoft.iis.web_app_pool:
    name: AppPool
    state: started

- name: Stop an application pool
  microsoft.iis.web_app_pool:
    name: AppPool
    state: stopped

- name: Restart an application pool (non-idempotent)
  microsoft.iis.web_app_pool:
    name: AppPool
    state: restarted

- name: Change application pool attributes using new dict style
  microsoft.iis.web_app_pool:
    name: AppPool
    attributes:
      managedRuntimeVersion: v4.0
      autoStart: false

- name: Creates an application pool, sets attributes and starts it
  microsoft.iis.web_app_pool:
    name: AnotherAppPool
    state: started
    attributes:
      managedRuntimeVersion: v4.0
      autoStart: false

- name: Creates an application pool with "No Managed Code" for .Net compatibility
  microsoft.iis.web_app_pool:
    name: AnotherAppPool
    state: started
    attributes:
      managedRuntimeVersion: ''
      autoStart: false

- name: Manage child element and set identity of application pool
  microsoft.iis.web_app_pool:
    name: IdentitiyAppPool
    state: started
    attributes:
      managedPipelineMode: Classic
      processModel.identityType: SpecificUser
      processModel.userName: "{{ ansible_user }}"
      processModel.password: "{{ ansible_password }}"
      processModel.loadUserProfile: true

- name: Manage a timespan attribute
  microsoft.iis.web_app_pool:
    name: TimespanAppPool
    state: started
    attributes:
      recycling.periodicRestart.time: "00:00:05:00.000000"
      recycling.periodicRestart.schedule: ["00:10:00", "05:30:00"]
      processModel.pingResponseTime: "00:03:00"

Авторы

Henrik Wallström (@henrikwallstrom)
Jordan Borean (@jborean93)

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

© 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_app_pool_module.html