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

Configures a IIS Web site.

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

Authors: Henrik Wallström

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.5.15

Description

Creates, Removes and configures a IIS Web site

Usage examples

  • 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
  • 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:
    aliases: []
    default: null
    description:
    - The IP address to bind to / use for the new site.
    required: false

ssl:
    aliases: []
    default: null
    description:
    - Enables HTTPS binding on the site..
    required: false

name:
    aliases: []
    default: null
    description:
    - Names of web site
    required: true

port:
    aliases: []
    default: null
    description:
    - The port to bind to / use for the new site.
    required: false

state:
    aliases: []
    choices:
    - started
    - restarted
    - stopped
    - absent
    default: null
    description:
    - State of the web site
    required: false

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

hostname:
    aliases: []
    default: null
    description:
    - The host header to bind to / use for the new site.
    required: false

parameters:
    aliases: []
    default: null
    description:
    - Custom site Parameters from string where properties are separated by a pipe and
      property name/values by colon Ex. "foo:1|bar:2"
    required: false

physical_path:
    aliases: []
    default: null
    description:
    - The physical path on the remote host to use for the new site. The specified folder
      must already exist.
    required: false

application_pool:
    aliases: []
    default: null
    description:
    - The application pool in which the new site executes.
    required: false