W3cubDocs

/Ansible

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.

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

© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/win_iis_webbinding_module.html