community.windows.win_iis_webapplication – Configures IIS web applications

community.windows.win_iis_webapplication – Configures IIS web applications

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.

• Synopsis
• Parameters
• See Also
• Examples
• Return Values

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	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	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)

© 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