community.windows.win_iis_webapplication – Configures IIS web applications
Note
This plugin is part of the community.windows collection (version 1.8.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
.
Parameters
Parameter |
Comments |
---|---|
The application pool in which the new site executes. If not specified, the application pool of the current website will be used. |
|
The type of authentication to use for this application. Either If If Choices:
|
|
Name of the web application. |
|
The password associated with username. Required when connect_as is set to |
|
The physical path on the remote host to use for the new application. The specified folder must already exist. |
|
Name of the site on which the application is created. |
|
State of the web application. Choices:
|
|
Specifies the user name of an account that can access configuration files and content for this application. Required when connect_as is set to |
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 |
Description |
---|---|
The used/implemented application_pool value. Returned: success Sample: “DefaultAppPool” |
|
How IIS will try to authenticate to the physical_path. Returned: when the application exists Sample: “specific_user” |
|
The used/implemented physical_path value. Returned: success Sample: “C:\\apps\\acme\\api” |
Authors
Henrik Wallström (@henrikwallstrom)