community.windows.win_iis_webapplication – Configures IIS web applications

Note

This plugin is part of the community.windows collection (version 1.9.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.windows.

To use it in a playbook, specify: community.windows.win_iis_webapplication.

Synopsis

  • Creates, removes, and configures IIS web applications.

Parameters

Parameter Choices/Defaults Comments
application_pool
string
The application pool in which the new site executes.
If not specified, the application pool of the current website will be used.
connect_as
string
    Choices:
  • pass_through
  • specific_user
The type of authentication to use for this application. Either pass_through or specific_user
If pass_through, IIS will use the identity of the user or application pool identity to access the file system or network.
If specific_user, IIS will use the credentials provided in username and password to access the file system or network.
name
string / required
Name of the web application.
password
string
The password associated with username.
Required when connect_as is set to specific_user.
physical_path
string
The physical path on the remote host to use for the new application.
The specified folder must already exist.
site
string / required
Name of the site on which the application is created.
state
string
    Choices:
  • absent
  • present ←
State of the web application.
username
string
Specifies the user name of an account that can access configuration files and content for this application.
Required when connect_as is set to specific_user.

See Also

See also

community.windows.win_iis_virtualdirectory

The official documentation on the community.windows.win_iis_virtualdirectory module.

community.windows.win_iis_webapppool

The official documentation on the community.windows.win_iis_webapppool module.

community.windows.win_iis_webbinding

The official documentation on the community.windows.win_iis_webbinding module.

community.windows.win_iis_website

The official documentation on the community.windows.win_iis_website module.

Examples

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

Return Values

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

Key Returned Description
application_pool
string
success
The used/implemented application_pool value.

Sample:
DefaultAppPool
connect_as
string
when the application exists
How IIS will try to authenticate to the physical_path.

Sample:
specific_user
physical_path
string
success
The used/implemented physical_path value.

Sample:
C:\apps\acme\api


Authors

  • Henrik Wallström (@henrikwallstrom)