Модуль community.windows.win_iis_webbinding — настраивает привязку веб-сайта IIS

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_iis_webbinding.

УСТАРЕЛО
Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения
Статус

УСТАРЕЛО

Удаляется в:: версии 4.0.0
Причина:: Этот модуль признан устаревшим; альтернативный поддерживаемый модуль доступен в коллекции microsoft.iis.
Альтернатива:: Вместо него используйте microsoft.iis.website.

Краткое описание

Создаёт, удаляет и настраивает привязку для существующего веб-сайта IIS.

Параметры

Параметр	Комментарии
certificate_hash string	Хэш сертификата (отпечаток) для привязки SSL. Хэш сертификата — уникальный идентификатор сертификата.
certificate_store_name string	Имя хранилища сертификатов, в котором находится сертификат для привязки. По умолчанию: `"my"`
host_header string	Заголовок хоста, который будет привязан к новому сайту или использоваться для него. При создании или удалении привязки для всех хостов не указывайте этот параметр вместо того, чтобы задавать для него значение «*».
ip string	IP-адрес, который будет привязан к новому сайту или использоваться для него. По умолчанию: `"*"`
name псевдонимы: website string / обязательный	Имя веб-сайта.
port integer	Порт, который будет привязан к новому сайту или использоваться для него. По умолчанию: `80`
protocol string	Протокол для веб-привязки (обычно HTTP, HTTPS или FTP). По умолчанию: `"http"`
ssl_flags string	Этот параметр действителен только для Server 2012 и более поздних версий. В основном используется для включения и отключения индикации имени сервера (SNI). Задайте значение `0`, чтобы отключить SNI. Задайте значение `1`, чтобы включить SNI.
state string	Состояние привязки. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

community.windows.win_iis_virtualdirectory: Настраивает виртуальный каталог в IIS.
community.windows.win_iis_webapplication: Настраивает веб-приложения IIS.
community.windows.win_iis_webapppool: Настраивает пулы веб-приложений IIS.
community.windows.win_iis_website: Настраивает веб-сайт IIS.

Примеры

- 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 dictionary	Информация об изменяемой привязке Возвращается: при успешном выполнении Пример: `"\"binding_info\": {\n \"bindingInformation\": \"127.0.0.1:443:\",\n \"certificateHash\": \"FF3910CE089397F1B5A77EB7BAFDD8F44CDE77DD\",\n \"certificateStoreName\": \"MY\",\n \"hostheader\": \"\",\n \"ip\": \"127.0.0.1\",\n \"port\": 443,\n \"protocol\": \"https\",\n \"sslFlags\": \"not supported\"\n}"`
operation_type string	Тип выполненной операции Возможные значения: удалена, обновлена, совпадает или добавлена Возвращается: при успешном выполнении Пример: `"removed"`
website_state string	Состояние целевого веб-сайта Может быть полезно, если вы случайно вызовете конфликт привязок, в результате которого целевой сайт будет остановлен Возвращается: всегда Пример: `"Started"`

Статус

Этот модуль будет удалён в версии 4.0.0. [устарело]
Подробнее см. в разделе УСТАРЕЛО.

Авторы

Noah Sparks (@nwsparks)
Henrik Wallström (@henrikwallstrom)

Ссылки на коллекцию

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