community.windows.win_iis_webapppool 模块 – 配置 IIS Web 应用程序池

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定： community.windows.win_iis_webapppool。

概要 

创建、删除和配置 IIS Web 应用程序池。

参数 

参数	注释
attributes 字符串	此字段是应用程序池属性的自由格式字典值。这些属性基于 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’ 并且您收到“值不在预期范围内”错误时，您的密钥存储已损坏。请按照 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 Web 应用程序。
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 复杂	有关应用程序池当前状态的信息。有关基于 IIS 版本的完整返回属性列表，请参阅https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005。已返回: 成功
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 字典	显示当前应用程序池 CPU 属性的键值对。已返回: 成功示例： `{"action": "NoAction", "limit": 0, "resetInterval": {"Days": 0, "Hours": 0}}`
failure 字典	显示当前应用程序池失败属性的键值对。已返回: 成功示例： `{"autoShutdownExe": "", "orphanActionExe": "", "rapidFailProtextionInterval": {"Days": 0, "Hours": 0}}`
name 字符串	此模块调用处理的应用程序池的名称。已返回: 成功示例： `"DefaultAppPool"`
processModel 字典	显示当前应用程序池 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 (@henrikwallstrom)
Jordan Borean (@jborean93)