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

Примечание

Этот плагин входит в состав коллекции community.windows (версия 1.2.0).

Для его установки используйте: 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: Официальная документация по модулю community.windows.win_iis_virtualdirectory.
community.windows.win_iis_webapplication: Официальная документация по модулю community.windows.win_iis_webapplication.
community.windows.win_iis_webbinding: Официальная документация по модулю community.windows.win_iis_webbinding.
community.windows.win_iis_website: Официальная документация по модулю community.windows.win_iis_website.

Примеры

- 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: no

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

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

Авторы

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

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