W3cubDocs

/Ansible

win_iis_virtualdirectory - Configures a virtual directory in IIS.

New in version 2.0.

Synopsis

Creates, Removes and configures a virtual directory in IIS.

Options

parameter required default choices comments
application
 no
The application under which the virtual directory is created or exists.
name
 yes
The name of the virtual directory to create or remove
physical_path
 no
The physical path to the folder in which the new virtual directory is created. The specified folder must already exist.
site
 yes
The site name under which the virtual directory is created or exists.
state
 no present
  • absent
  • present
Whether to add or remove the specified virtual directory

Examples

# This creates a virtual directory if it doesn't exist.
$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite state=present physical_path=c:\virtualdirectory\some" host

# This removes a virtual directory if it exists.
$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite state=absent" host

# This creates a virtual directory on an application if it doesn't exist.
$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite application=someapp state=present physical_path=c:\virtualdirectory\some" host

This is an Extras Module

For more information on what this means please read Extras Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/win_iis_virtualdirectory_module.html