win_iis_virtualdirectory - Configures a virtual directory in IIS.

New in version 2.0.

Synopsis

  • Creates, Removes and configures a virtual directory in IIS.

Parameters

Parameter Choices/Defaults Comments
application Default:
None
The application under which the virtual directory is created or exists.
name
required
The name of the virtual directory to create or remove
physical_path Default:
None
The physical path to the folder in which the new virtual directory is created. The specified folder must already exist.
site
required
The site name under which the virtual directory is created or exists.
state
    Choices:
  • absent
  • present ←
Whether to add or remove the specified virtual directory

Examples

- name: Create a virtual directory if it does not exist
  win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: present
    physical_path: c:\virtualdirectory\some

- name: Remove a virtual directory if it exists
  win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: absent

- name: Create a virtual directory on an application if it does not exist
  win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    application: someapp
    state: present
    physical_path: c:\virtualdirectory\some

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Author

  • Henrik Wallström

Hint

If you notice any issues in this documentation you can edit this document to improve it.

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