win_iis_webbinding – Настройка привязки веб-сайта IIS
Новое в версии 2.0.
Описание
- Создаёт, удаляет и настраивает привязку к существующему веб-сайту IIS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_hash
-
|
Хеш сертификата (отпечаток) для привязки SSL. Хеш сертификата — уникальный идентификатор сертификата. |
|
| certificate_store_name
-
|
По умолчанию: "my" |
Имя хранилища сертификатов, где расположен сертификат для привязки. |
| host_header
-
|
Заголовок хоста для привязки/использования для нового сайта.
Если вы создаёте/удаляете привязку «catch-all», опустите этот параметр, а не определяйте его как «*». |
|
| ip
-
|
По умолчанию: "*" |
IP-адрес для привязки/использования для нового сайта. |
| name
- / обязательно
|
Название веб-сайта.
псевдонимы: сайт |
|
| port
-
|
По умолчанию: 80 |
Порт для привязки/использования для нового сайта. |
| protocol
-
|
По умолчанию: "http" |
Протокол, который будет использоваться для привязки веб-сайта (обычно HTTP, HTTPS или FTP). |
| ssl_flags
-
добавлен в 2.5
|
Этот параметр действителен только на серверах Server 2012 и новее.
В основном используется для включения и отключения указания имени сервера (SNI).
Установите c(0), чтобы отключить SNI.
Установите c(1), чтобы включить SNI. |
|
| state
-
|
|
Состояние привязки. |
Примеры
- 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: Remove the default http binding
win_iis_webbinding:
name: Default Web Site
port: 80
ip: '*'
state: absent
- name: Add a HTTPS binding
win_iis_webbinding:
name: Default Web Site
protocol: https
port: 443
ip: 127.0.0.1
certificate_hash: B0D0FA8408FC67B230338FCA584D03792DA73F4C
state: present
- name: Add a HTTPS binding with host header and SNI enabled
win_iis_webbinding:
name: Default Web Site
protocol: https
port: 443
host_header: test.com
ssl_flags: 1
certificate_hash: D1A3AF8988FD32D1A3AF8988FD323792DA73F4C
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| binding_info
словарь
добавлен в 2.5
|
при успехе | Информация о манипулируемой привязке
Пример:
"binding_info": { "bindingInformation": "127.0.0.1:443:", "certificateHash": "FF3910CE089397F1B5A77EB7BAFDD8F44CDE77DD", "certificateStoreName": "MY", "hostheader": "", "ip": "127.0.0.1", "port": 443, "protocol": "https", "sslFlags": "не поддерживается" }
|
| operation_type
строка
добавлен в 2.5
|
при успехе | Тип выполненной операции
Может быть удалён, обновлён, сопоставлен или добавлен
Пример:
удален
|
| website_state
строка
добавлен в 2.5
|
всегда | Состояние целевого веб-сайта
Может быть полезно в случае случайного столкновения привязок, что может привести к остановке целевого сайта
Пример:
Запущен
|
Статус
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Noah Sparks (@nwsparks)
- Henrik Wallström
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_iis_webbinding_module.html