Модуль community.windows.win_iis_webapppool — настройка пулов веб-приложений IIS

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

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

Для установки используйте: ansible-galaxy collection install community.windows.

Чтобы использовать коллекцию в плейбуке, укажите: community.windows.win_iis_webapppool.

УСТАРЕЛО
Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения
Статус

УСТАРЕЛО

Удалено в:: версии 4.0.0
Причина:: Этот модуль устарел, и в коллекции microsoft.iis доступен поддерживаемый альтернативный модуль.
Альтернатива:: Вместо него используйте microsoft.iis.web_app_pool.

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

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

Параметры

Параметр	Комментарии
attributes string	Это поле представляет собой словарь произвольного формата со значениями атрибутов пула приложений. Имена этих атрибутов соответствуют стандарту, описанному на странице 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’ появляется ошибка ‘Value does fall within the expected range’, значит, хранилище ключей повреждено. Чтобы исправить это на узле, следуйте инструкциям на странице http://structuredsight.com/2014/10/26/im-out-of-range-youre-out-of-range/.
name string / обязательный	Имя пула приложений.
state string	Состояние пула приложений. Если задано `absent`, пул приложений будет удален. Если задано `present`, пул приложений будет настроен и создан. Если задано `restarted`, пул приложений будет создан и перезапущен. Это действие никогда не является идемпотентным. Если задано `started`, пул приложений будет создан и запущен. Если задано `stopped`, пул приложений будет создан и остановлен. Варианты: `"absent"` `"present"` ← (по умолчанию) `"restarted"` `"started"` `"stopped"`

См. также

community.windows.win_iis_virtualdirectory: Настраивает виртуальный каталог в IIS.
community.windows.win_iis_webapplication: Настраивает веб-приложения IIS.
community.windows.win_iis_webbinding: Настраивает привязку веб-сайта IIS.
community.windows.win_iis_website: Настраивает веб-сайт IIS.

Примеры

- name: Return information about an existing application pool
  community.windows.win_iis_webapppool:
    name: DefaultAppPool
    state: present

- name: Create a new application pool in 'Started' state
  community.windows.win_iis_webapppool:
    name: AppPool
    state: started

- name: Stop an application pool
  community.windows.win_iis_webapppool:
    name: AppPool
    state: stopped

- name: Restart an application pool (non-idempotent)
  community.windows.win_iis_webapppool:
    name: AppPool
    state: restarted

- name: Change application pool attributes using new dict style
  community.windows.win_iis_webapppool:
    name: AppPool
    attributes:
      managedRuntimeVersion: v4.0
      autoStart: false

- name: Creates an application pool, sets attributes and starts it
  community.windows.win_iis_webapppool:
    name: AnotherAppPool
    state: started
    attributes:
      managedRuntimeVersion: v4.0
      autoStart: false

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

# In the below example we are setting attributes in child element processModel
# https://www.iis.net/configreference/system.applicationhost/applicationpools/add/processmodel
- name: Manage child element and set identity of application pool
  community.windows.win_iis_webapppool:
    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
  community.windows.win_iis_webapppool:
    name: TimespanAppPool
    state: started
    attributes:
      # Timespan with full string "day:hour:minute:second.millisecond"
      recycling.periodicRestart.time: "00:00:05:00.000000"
      recycling.periodicRestart.schedule: ["00:10:00", "05:30:00"]
      # Shortened timespan "hour:minute:second"
      processModel.pingResponseTime: "00:03:00"

Возвращаемые значения

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

Ключ	Описание
attributes dictionary	Атрибуты пула приложений, заданные и обработанные при вызове этого модуля. Возвращается: при успешном выполнении Пример: `{"enable32BitAppOnWin64": "true", "managedPipelineMode": "Classic", "managedRuntimeVersion": "v4.0"}`
info complex	Сведения о текущем состоянии пула приложений. Полный список возвращаемых атрибутов для вашей версии IIS см. на странице https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005. Возвращается: при успешном выполнении
attributes dictionary	Пары «ключ-значение», отражающие текущие атрибуты пула приложений. Возвращается: при успешном выполнении Пример: `{"CLRConfigFile": "", "applicationPoolSid": "S-1-5-82-1352790163-598702362-1775843902-1923651883-1762956711", "autoStart": true, "enable32BitAppOnWin64": true, "enableConfigurationOverride": true, "managedPipelineMode": "Classic", "managedRuntimeLoader": "webengine4.dll", "managedRuntimeVersion": "v4.0", "name": "DefaultAppPool", "passAnonymousToken": true, "queueLength": 1000, "startMode": "OnDemand", "state": "Started"}`
cpu dictionary	Пары «ключ-значение», отражающие текущие атрибуты cpu пула приложений. Возвращается: при успешном выполнении Пример: `{"action": "NoAction", "limit": 0, "resetInterval": {"Days": 0, "Hours": 0}}`
failure dictionary	Пары «ключ-значение», отражающие текущие атрибуты failure пула приложений. Возвращается: при успешном выполнении Пример: `{"autoShutdownExe": "", "orphanActionExe": "", "rapidFailProtextionInterval": {"Days": 0, "Hours": 0}}`
name string	Имя пула приложений, обработанного при вызове этого модуля. Возвращается: при успешном выполнении Пример: `"DefaultAppPool"`
processModel dictionary	Пары «ключ-значение», отражающие текущие атрибуты processModel пула приложений. Возвращается: при успешном выполнении Пример: `{"identityType": "ApplicationPoolIdentity", "logonType": "LogonBatch", "pingInterval": {"Days": 0, "Hours": 0}}`
recycling dictionary	Пары «ключ-значение», отражающие текущие атрибуты recycling пула приложений. Возвращается: при успешном выполнении Пример: `{"disallowOverlappingRotation": false, "disallowRotationOnConfigChange": false, "logEventOnRecycle": "Time,Requests,Schedule,Memory,IsapiUnhealthy,OnDemand,ConfigChange,PrivateMemory"}`
state string	Текущее состояние пула во время выполнения модуля. Возвращается: при успешном выполнении Пример: `"Started"`

Статус

Этот модуль будет удален в версии 4.0.0. [устарело]
Дополнительные сведения см. в разделе УСТАРЕЛО.

Авторы

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/community/windows/win_iis_webapppool_module.html