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

Примечание

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

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

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

Чтобы использовать её в книге задач, укажите: community.windows.win_iis_webapppool.

Обзор
Параметры
См. также
Примеры
Возвращаемые значения

Обзор

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

Параметры

Параметр	Комментарии
attributes строка	Это поле — свободное значение словаря для атрибутов пула приложений. Эти атрибуты основаны на стандартной схеме именования по адресу https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005, см. раздел с примерами для получения более подробной информации о настройке. Вы также можете настроить атрибуты дочерних элементов, таких как cpu и processModel; см. примеры для получения информации о том, как это делается. Хотя вы можете использовать числовые значения для перечислений, рекомендуется использовать само имя перечисления, например, используйте SpecificUser вместо 3 для processModel.identityType. 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"`

См. также

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 словарь	Атрибуты пула приложений, которые были установлены и обработаны этим вызовом модуля. Возвращается при: успехе Пример: `{"enable32BitAppOnWin64": "true", "managedPipelineMode": "Classic", "managedRuntimeVersion": "v4.0"}`
info сложный тип	Информация о текущем состоянии пула приложений. См. https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005 для полного списка атрибутов возврата, в зависимости от версии IIS. Возвращается при: успехе
attributes словарь	Пара ключ-значение, отображающие текущие атрибуты пула приложений. Возвращается при: успехе Пример: `{"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 словарь	Пара ключ-значение, отображающие текущие атрибуты процессора пула приложений. Возвращается при: успехе Пример: `{"action": "NoAction", "limit": 0, "resetInterval": {"Days": 0, "Hours": 0}}`
failure словарь	Пара ключ-значение, отображающие текущие атрибуты ошибок пула приложений. Возвращается при: успехе Пример: `{"autoShutdownExe": "", "orphanActionExe": "", "rapidFailProtextionInterval": {"Days": 0, "Hours": 0}}`
name строка	Имя пула приложений, который был обработан этим модулем. Возвращается при: успехе Пример: `"DefaultAppPool"`
processModel словарь	Пара ключ-значение, отображающие текущие атрибуты процесса пула приложений. Возвращается при: успехе Пример: `{"identityType": "ApplicationPoolIdentity", "logonType": "LogonBatch", "pingInterval": {"Days": 0, "Hours": 0}}`
recycling словарь	Пара ключ-значение, отображающие текущие атрибуты рециклинга пула приложений. Возвращается при: успехе Пример: `{"disallowOverlappingRotation": false, "disallowRotationOnConfigChange": false, "logEventOnRecycle": "Time,Requests,Schedule,Memory,IsapiUnhealthy,OnDemand,ConfigChange,PrivateMemory"}`
state строка	Текущее состояние пула во время завершения модуля. Возвращается при: успехе Пример: `"Started"`

Авторы

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

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_iis_webapppool_module.html