Documentation

win_iis_webbinding - Configures a IIS Web site.

New in version 2.0.

Synopsis

  • Creates, Removes and configures a binding to an existing IIS Web site

Options

parameter required default choices comments
certificate_hash
no
Certificate hash for the SSL binding. The certificate hash is the unique identifier for the certificate.
certificate_store_name
no My
Name of the certificate store where the certificate for the binding is located.
host_header
no
The host header to bind to / use for the new site.
ip
no
The IP address to bind to / use for the new site.
name
yes
Names of web site
port
no
The port to bind to / use for the new site.
protocol
no
The protocol to be used for the Web binding (usually HTTP, HTTPS, or FTP).
state
no
  • present
  • absent
State of the binding

Examples

- name: Return binding information for an existing host
  win_iis_webbinding:
    name: Default Web Site

- name: Return the HTTPS binding information for an existing host
  win_iis_webbinding:
    name: Default Web Site
    protocol: https

- name: Add a HTTP binding on port 9090
  win_iis_webbinding:
    name: Default Web Site
    port: 9090
    state: present

- name: Remove the HTTP binding on port 9090
  win_iis_webbinding:
    name: Default Web Site
    port: 9090
    state: absent

- name: Add a HTTPS binding
  win_iis_webbinding:
    name: Default Web Site
    protocol: https
    state: present

- name: Add a HTTPS binding and select certificate to use
  win_iis_webbinding:
    name: Default Web Site
    protocol: https
    certificate_hash: B0D0FA8408FC67B230338FCA584D03792DA73F4C
    state: present

- name: Website https biding to specific port
  win_iis_webbinding:
    name: Default Web Site
    protocol: https
    port: 443
    certificate_hash: D1A3AF8988FD32D1A3AF8988FD323792DA73F4C
    state: present

Status

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

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.