Documentation

win_iis_webapplication - Configures IIS web applications

New in version 2.0.

Synopsis

  • Creates, removes, and configures IIS web applications.

Options

parameter required default choices comments
application_pool
no
The application pool in which the new site executes.
name
yes
Name of the web application.
physical_path
no
The physical path on the remote host to use for the new application.
The specified folder must already exist.
site
yes
Name of the site on which the application is created.
state
no present
  • absent
  • present
State of the web application.

Examples

- name: Add ACME webapplication on IIS.
  win_iis_webapplication:
    name: api
    site: acme
    state: present
    physical_path: C:\apps\acme\api

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
physical_path
The used/implemented physical_path value
success string C:\apps\acme\api
application_pool
The used/implemented application_pool value
success string DefaultAppPool


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.