win_iis_webapppool – Configure IIS Web Application Pools¶
Parameters¶
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| attributes 
                    -
                                                                 | This field is a free form dictionary value for the application pool attributes. These attributes are based on the naming standard at https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005, see the examples section for more details on how to set this. You can also set the attributes of child elements like cpu and processModel, see the examples to see how it is done. While you can use the numeric values for enums it is recommended to use the enum name itself, e.g. use SpecificUser instead of 3 for processModel.identityType. managedPipelineMode may be either "Integrated" or "Classic". startMode may be either "OnDemand" or "AlwaysRunning". Use  statemodule parameter to modify the state of the app pool.When trying to set 'processModel.password' and you receive a 'Value does fall within the expected range' error, you have a corrupted keystore. Please follow http://structuredsight.com/2014/10/26/im-out-of-range-youre-out-of-range/ to help fix your host. | |
| name 
                    string
                                             / required                     | Name of the application pool. | |
| state 
                    string
                                                                 | 
 | The state of the application pool. If  absentwill ensure the app pool is removed.If  presentwill ensure the app pool is configured and exists.If  restartedwill ensure the app pool exists and will restart, this is never idempotent.If  startedwill ensure the app pool exists and is started.If  stoppedwill ensure the app pool exists and is stopped. | 
See Also¶
See also
- win_iis_virtualdirectory – Configures a virtual directory in IIS
- The official documentation on the win_iis_virtualdirectory module.
- win_iis_webapplication – Configures IIS web applications
- The official documentation on the win_iis_webapplication module.
- win_iis_webbinding – Configures a IIS Web site binding
- The official documentation on the win_iis_webbinding module.
- win_iis_website – Configures a IIS Web site
- The official documentation on the win_iis_website module.
Examples¶
- 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: restarted
- 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"
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Henrik Wallström (@henrikwallstrom)
- Jordan Borean (@jborean93)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
