Note
This plugin is part of the community.windows collection (version 1.2.0).
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/2.11/collections/community/windows/win_iis_webapplication_module.html