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

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Creates, Removes and configures a IIS Web site.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Start a website

- name: Acme IIS site
  win_iis_website:
    name: Acme
    state: started
    port: 80
    ip: 127.0.0.1
    hostname: acme.local
    application_pool: acme
    physical_path: C:\sites\acme
    parameters: logfile.directory:C:\sites\logs
  register: website

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Remove Default Web Site and the standard port 80 binding
- name: Remove Default Web Site
  win_iis_website:
    name: "Default Web Site"
    state: absent

Inputs

    
ip:
    description:
    - The IP address to bind to / use for the new site.
    type: str

ssl:
    description:
    - Enables HTTPS binding on the site..
    type: str

name:
    description:
    - Names of web site.
    required: true
    type: str

port:
    description:
    - The port to bind to / use for the new site.
    type: int

state:
    choices:
    - absent
    - started
    - stopped
    - restarted
    description:
    - State of the web site
    type: str

site_id:
    description:
    - Explicitly set the IIS numeric ID for a site.
    - Note that this value cannot be changed after the website has been created.
    type: str
    version_added: '2.1'
    version_added_collection: ansible.builtin

hostname:
    description:
    - The host header to bind to / use for the new site.
    type: str

parameters:
    description:
    - Custom site Parameters from string where properties are separated by a pipe and
      property name/values by colon Ex. "foo:1|bar:2"
    type: str

physical_path:
    description:
    - The physical path on the remote host to use for the new site.
    - The specified folder must already exist.
    type: str

application_pool:
    description:
    - The application pool in which the new site executes.
    type: str

See also

• win_iis_virtualdirectory
• win_iis_webapplication
• win_iis_webapppool
• win_iis_webbinding