Note
This plugin is part of the community.windows collection (version 1.7.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.
| 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 |
| 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 |
| 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
The official documentation on the community.windows.win_iis_virtualdirectory module.
The official documentation on the community.windows.win_iis_webapppool module.
The official documentation on the community.windows.win_iis_webbinding module.
The official documentation on the community.windows.win_iis_website module.
- name: Add ACME webapplication on IIS.
community.windows.win_iis_webapplication:
name: api
site: acme
state: present
physical_path: C:\apps\acme\api
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 |
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_iis_webapplication_module.html