win_iis_webbinding - Настройка привязки веб-сайта IIS.
Новая в версии 2.0.
Описание
- Создаёт, удаляет и настраивает привязку к существующему веб-сайту IIS
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_hash | Хэш сертификата (отпечаток) для SSL-привязки. Хэш сертификата — уникальный идентификатор сертификата. | |
| certificate_store_name | По умолчанию: my | Имя хранилища сертификатов, в котором находится сертификат для привязки. |
| host_header | Заголовок хоста для привязки / использования для нового сайта. Если вы создаёте/удаляете универсальную привязку, опустите этот параметр, вместо того, чтобы задавать его как '*'. | |
| ip | По умолчанию: * | IP-адрес для привязки / использования для нового сайта. |
| name обязательно | Имя веб-сайта псевдонимы: сайт | |
| port | По умолчанию: 80 | Порт для привязки / использования для нового сайта. |
| protocol | По умолчанию: http | Протокол, используемый для привязки веб-сайта (обычно HTTP, HTTPS или FTP). |
| ssl_flags (добавлено в 2.5) | Этот параметр действителен только на серверах Windows 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 словарь | при успехе | Информация о манипулируемой привязке Пример: "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 строка | при успехе | Тип выполненной операции Может быть удалено, обновлено, сопоставлено или добавлено Пример: удалено |
| website_state строка | всегда | Состояние веб-сайта, на который нацелена операция Может быть полезно в случае, если вы случайно создадите конфликт привязок, что может привести к остановке целевого сайта Пример: Запущен |
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/win_iis_webbinding_module.html