Documentation

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, Helping Testing PRs and Developing Modules.