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

# This will return binding information for an existing host
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site'" windows
host | success >> {
    "added": [],
    "changed": false,
    "matched": [
        {
            "bindingInformation": "*:80:",
            "certificateHash": "",
            "certificateStoreName": "",
            "isDsMapperEnabled": false,
            "protocol": "http",
            "sslFlags": 0
        }
    ],
    "parameters": {
        "Name": "Default Web Site"
    },
    "removed": []
}

# This will return the HTTPS binding information for an existing host
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' protocol=https" windows

# This will return the HTTPS binding information for an existing host
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' port:9090 state=present" windows

# This will add a HTTP binding on port 9090
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' port=9090 state=present" windows

# This will remove the HTTP binding on port 9090
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' port=9090 state=present" windows

# This will add a HTTPS binding
$ ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' protocol=https state=present" windows

# This will add a HTTPS binding and select certificate to use
# ansible -i vagrant-inventory -m win_iis_webbinding -a "name='Default Web Site' protocol=https certificate_hash= B0D0FA8408FC67B230338FCA584D03792DA73F4C" windows


# Playbook example
---

- name: Website http/https bidings
  win_iis_webbinding:
    name: "Default Web Site"
    protocol: https
    port: 443
    certificate_hash: "D1A3AF8988FD32D1A3AF8988FD323792DA73F4C"
    state: present
  when: monitor_use_https

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, developing_test_pr and Developing Modules.

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