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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.windows.

Для использования в плейбуке укажите: community.windows.win_iis_webbinding.

Описание
Параметры
См. также
Примеры
Возвращаемые значения

Описание

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

Параметры

Параметр	Комментарии
certificate_hash строка	Хэш сертификата (отпечаток) для привязки SSL. Хэш сертификата — уникальный идентификатор сертификата.
certificate_store_name строка	Имя хранилища сертификатов, в котором расположен сертификат для привязки. По умолчанию: `"my"`
host_header строка	Заголовок хоста для привязки / использования для нового сайта. Если вы создаете/удаляете универсальную привязку, опустите этот параметр вместо определения его как «*».
ip строка	IP-адрес для привязки / использования для нового сайта. По умолчанию: `"*"`
name псевдонимы: website строка / обязательно	Имена веб-сайта.
port целое число	Порт для привязки / использования для нового сайта. По умолчанию: `80`
protocol строка	Протокол, используемый для привязки веб-сайта (обычно HTTP, HTTPS или FTP). По умолчанию: `"http"`
ssl_flags строка	Этот параметр действителен только на серверах Server 2012 и новее. В основном используется для включения и выключения указания имени сервера (SNI). Установите `0` для отключения SNI. Установите `1` для включения SNI.
state строка	Состояние привязки. Варианты: `"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 словарь	Информация о манипулируемой привязке Возвращается: при успехе Пример: `"\"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 строка	Тип выполненной операции Может быть удалением, обновлением, соответствием или добавлением Возвращается: при успехе Пример: `"removed"`
website_state строка	Состояние целевого веб-сайта Полезно в случае случайного столкновения привязок, что может привести к остановке целевого сайта Возвращается: всегда Пример: `"Started"`

Авторы

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

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

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