ansible / ansible.builtin / v2.8.15 / module / win_iis_webapppool Configure IIS Web Application Pools | "added in version" 2.0 of ansible.builtin" Authors: Henrik Wallström (@henrikwallstrom), Jordan Borean (@jborean93) preview | supported by communityansible.builtin.win_iis_webapppool (v2.8.15) — module
pip
Install with pip install ansible==2.8.15
Creates, removes and configures an IIS Web Application Pool.
- 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"
name: description: - Name of the application pool. required: true type: str state: choices: - absent - present - restarted - started - stopped default: present description: - The state of the application pool. - If C(absent) will ensure the app pool is removed. - If C(present) will ensure the app pool is configured and exists. - If C(restarted) will ensure the app pool exists and will restart, this is never idempotent. - If C(started) will ensure the app pool exists and is started. - If C(stopped) will ensure the app pool exists and is stopped. type: str attributes: description: - This field is a free form dictionary value for the application pool attributes. - These attributes are based on the naming standard at U(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 C(state) module 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 U(http://structuredsight.com/2014/10/26/im-out-of-range-youre-out-of-range/) to help fix your host.
attributes: description: Application Pool attributes that were set and processed by this module invocation. returned: success sample: enable32BitAppOnWin64: 'true' managedPipelineMode: Classic managedRuntimeVersion: v4.0 type: dict info: contains: attributes: description: Key value pairs showing the current Application Pool attributes. returned: success sample: 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 type: dict cpu: description: Key value pairs showing the current Application Pool cpu attributes. returned: success sample: action: NoAction limit: 0 resetInterval: Days: 0 Hours: 0 type: dict failure: description: Key value pairs showing the current Application Pool failure attributes. returned: success sample: autoShutdownExe: '' orphanActionExe: '' rapidFailProtextionInterval: Days: 0 Hours: 0 type: dict name: description: Name of Application Pool that was processed by this module invocation. returned: success sample: DefaultAppPool type: str processModel: description: Key value pairs showing the current Application Pool processModel attributes. returned: success sample: identityType: ApplicationPoolIdentity logonType: LogonBatch pingInterval: Days: 0 Hours: 0 type: dict recycling: description: Key value pairs showing the current Application Pool recycling attributes. returned: success sample: disallowOverlappingRotation: false disallowRotationOnConfigChange: false logEventOnRecycle: Time,Requests,Schedule,Memory,IsapiUnhealthy,OnDemand,ConfigChange,PrivateMemory type: dict state: description: Current runtime state of the pool as the module completed. returned: success sample: Started type: str description: Information on current state of the Application Pool. See https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005 for the full list of return attributes based on your IIS version. returned: success sample: null type: complex