win_iis_webapppool - настраивает пул приложений веб-сайта IIS
Новая версия 2.0.
Описание
- Создаёт, удаляет и настраивает пул приложений веб-сайта IIS.
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| attributes | нет | Начиная с Ansible 2.4, это поле может содержать записи словаря для настройки атрибутов пула приложений. Эти атрибуты основаны на стандартной номенклатуре по адресу 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/ для устранения неполадок. УСТАРЕЛО Начиная с Ansible 2.4, это поле должно быть установлено в формате словаря, в более старых версиях Ansible это поле было строкой. Эта строка имеет атрибуты, разделенные символом '|' и имя/значения атрибутов через двоеточие ':'. Например: "startMode:OnDemand|managedPipelineMode:Classic". | ||
| name | да | Имя пула приложений. | ||
| state | нет | present |
| Состояние пула приложений. Если present гарантирует, что пул приложений настроен и существует.Если absent гарантирует, что пул приложений удалён.Если stopped гарантирует, что пул приложений существует и остановлен.Если started гарантирует, что пул приложений существует и запущен.Если restarted гарантирует, что пул приложений существует и будет перезапущен, это никогда не идемпотентно. |
Примеры
- 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: false
# Note this format style has been deprecated, please use the newer dict style instead
- name: change application pool attributes using older string style
win_iis_webapppool:
name: AppPool
attributes: 'managedRuntimeVersion:v4.0|autoStart:false'
# This is the preferred style to use when setting attributes
- name: creates an application pool, sets attributes and starts it
win_iis_webapppool:
name: AnotherAppPool
state: started
attributes:
managedRuntimeVersion: v4.0
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
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 | Атрибуты пула приложений, которые были настроены и обработаны этим вызовом модуля. | успех | словарь | {'managedPipelineMode': 'Classic', 'enable32BitAppOnWin64': 'true', 'managedRuntimeVersion': 'v4.0'} | ||||||||||||||||||||||||||||||||||||||||
| info | Информация о текущем состоянии пула приложений. Полный список возвращаемых атрибутов в зависимости от версии IIS см. по адресу https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005. | успех | сложное | None | ||||||||||||||||||||||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||||||||||||||||||||||
Статус
Этот модуль помечен как превью, что означает, что интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_iis_webapppool_module.html
