community.windows.win_iis_webbinding – Настройка привязки веб-сайта IIS
Примечание
Этот плагин входит в коллекцию community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Чтобы использовать его в книге задач, укажите: community.windows.win_iis_webbinding.
Обзор
- Создаёт, удаляет и настраивает привязку к существующему веб-сайту IIS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
certificate_hash
строка
|
Хеш сертификата (отпечаток) для привязки SSL. Хеш сертификата — уникальный идентификатор сертификата.
|
|
|
certificate_store_name
строка
|
По умолчанию: "my" |
Имя хранилища сертификатов, где расположен сертификат для привязки.
|
|
host_header
строка
|
Заголовок хоста для привязки / использования для нового сайта.
Если вы создаёте/удаляете универсальную привязку, опустите этот параметр, а не определяйте его как '*'.
|
|
|
ip
строка
|
По умолчанию: "*" |
IP-адрес для привязки / использования для нового сайта.
|
|
name
строка / обязательный
|
Название веб-сайта.
псевдонимы: веб-сайт |
|
|
port
строка
|
По умолчанию: 80 |
Порт для привязки / использования для нового сайта.
|
|
protocol
строка
|
По умолчанию: "http" |
Протокол, используемый для привязки веб-сайта (обычно HTTP, HTTPS или FTP).
|
|
ssl_flags
строка
|
Этот параметр действителен только для серверов Server 2012 и новее.
В основном используется для включения и выключения указания имени сервера (SNI).
Установите
0, чтобы отключить SNI.Установите
1, чтобы включить SNI. |
|
|
state
строка
|
|
Состояние привязки.
|
См. также
См. также
- community.windows.win_iis_virtualdirectory
-
Официальная документация по модулю community.windows.win_iis_virtualdirectory.
- community.windows.win_iis_webapplication
-
Официальная документация по модулю community.windows.win_iis_webapplication.
- community.windows.win_iis_webapppool
-
Официальная документация по модулю community.windows.win_iis_webapppool.
- community.windows.win_iis_website
-
Официальная документация по модулю community.windows.win_iis_website.
Примеры
- name: Add a HTTP binding on port 9090
community.windows.win_iis_webbinding:
name: Default Web Site
port: 9090
state: present
- name: Remove the HTTP binding on port 9090
community.windows.win_iis_webbinding:
name: Default Web Site
port: 9090
state: absent
- name: Remove the default http binding
community.windows.win_iis_webbinding:
name: Default Web Site
port: 80
ip: '*'
state: absent
- name: Add a HTTPS binding
community.windows.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
community.windows.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 (@henrikwallstrom)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_iis_webbinding_module.html