ansible.builtin.win_iis_virtualdirectory (v2.9.27) — module

Configures a virtual directory in IIS

| "added in version" 2.0 of ansible.builtin"

Authors: Henrik Wallström (@henrikwallstrom)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Creates, Removes and configures a virtual directory in IIS.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create a virtual directory if it does not exist
  win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: present
    physical_path: C:\virtualdirectory\some
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Remove a virtual directory if it exists
  win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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

Inputs

    
name:
    description:
    - The name of the virtual directory to create or remove.
    required: true
    type: str

site:
    description:
    - The site name under which the virtual directory is created or exists.
    required: true
    type: str

state:
    choices:
    - absent
    - present
    default: present
    description:
    - Whether to add or remove the specified virtual directory.
    - Removing will remove the virtual directory and all under it (Recursively).
    type: str

application:
    description:
    - The application under which the virtual directory is created or exists.
    type: str

physical_path:
    description:
    - The physical path to the folder in which the new virtual directory is created.
    - The specified folder must already exist.
    type: str

See also