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

Новое в версии 2.0.

Обзор
Параметры
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Создает, удаляет и настраивает пул приложений веб-приложения 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` гарантирует, что пул приложений существует и остановлен.

Примеры

- name: return information about an existing application pool
  win_iis_webapppool:
    name: DefaultAppPool
    state: present

- name: create a new application pool in 'Started' state
  win_iis_webapppool:
    name: AppPool
    state: started

- name: stop an application pool
  win_iis_webapppool:
    name: AppPool
    state: stopped

- name: restart an application pool (non-idempotent)
  win_iis_webapppool:
    name: AppPool
    state: restart

- name: change application pool attributes using new dict style
  win_iis_webapppool:
    name: AppPool
    attributes:
      managedRuntimeVersion: v4.0
      autoStart: no

- name: creates an application pool, sets attributes and starts it
  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
  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
  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', 'managedRuntimeVersion': 'v4.0', 'managedPipelineMode': 'Classic'}
info сложный		success	Информация о текущем состоянии пула приложений. Полный список возвращаемых атрибутов в зависимости от вашей версии IIS см. по адресу https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005.
	attributes словарь	success	Параметры ключей и значений, показывающие текущие атрибуты пула приложений. Пример: {'autoStart': True, 'managedRuntimeLoader': 'webengine4.dll', 'managedPipelineMode': 'Classic', 'name': 'DefaultAppPool', 'CLRConfigFile': '', 'passAnonymousToken': True, 'applicationPoolSid': 'S-1-5-82-1352790163-598702362-1775843902-1923651883-1762956711', 'queueLength': 1000, 'managedRuntimeVersion': 'v4.0', 'state': 'Started', 'enableConfigurationOverride': True, 'startMode': 'OnDemand', 'enable32BitAppOnWin64': True}
	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

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/win_iis_webapppool_module.html