модуль microsoft.iis.website_info — получение сведений о веб-сайтах IIS

Примечание

Этот модуль входит в коллекцию microsoft.iis (версия 1.2.0).

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

Для установки используйте: ansible-galaxy collection install microsoft.iis. Для использования этого модуля необходимы дополнительные требования. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: microsoft.iis.website_info.

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

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

Возвращает сведения о веб-сайтах IIS.

Требования

На узле, на котором выполняется этот модуль, должны быть соблюдены следующие требования.

Модуль PowerShell IISAdministration

Параметры

Параметр	Комментарии
name string	Имя веб-сайта. Если параметр не указан, будут получены сведения обо всех существующих веб-сайтах.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния без изменения целевого узла. Если режим не поддерживается, действие будет пропущено.
diff_mode	Поддержка: none	В режиме diff будут возвращены сведения о том, что изменилось (или, возможно, должно измениться в режиме check_mode).
platform	Платформа: windows	Целевые ОС и семейства ОС, с которыми можно работать

См. также

microsoft.iis.website: Настраивает веб-сайт IIS.

Примеры

- name: Return information about an existing website
  microsoft.iis.website_info:
    name: 'Default Web Site'
  register: stored_info

- name: Returns information about all websites that exist on the system
  microsoft.iis.website_info:
  register: stored_info_all

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
exists boolean	Найден ли хотя бы один веб-сайт. Возвращается: всегда Пример: `true`
site list / elements=dictionary	Содержит список словарей. Каждый словарь в списке содержит имя и сведения о веб-сайте. Возвращается: при успешном выполнении Пример: "[\n {\n \"name\": \"Default Web Site\",\n \"state\": \"Started\"\n \"site_id\": 1,\n \"physical_path\": \"C:\\\\inetpub\\\\wwwroot\",\n \"application_pool\": \"DefaultAppPool\",\n \"bindings\": [\n {\n \"ip\": \"127.0.0.1\",\n \"port\": 80,\n \"hostname\": \"iis_website.com\",\n \"protocol\": \"http\",\n \"use_ccs\": false,\n \"use_sni\": false\n }\n ]\n }\n]\n"
application_pool string	Указывает пул приложений, в котором выполняется веб-сайт. Возвращается: при успешном выполнении Пример: `"DefaultAppPool"`
bindings list / elements=dictionary	Список словарей, содержащих сведения обо всех привязках веб-сайта. Возвращается: при успешном выполнении
certificate_hash string	Хэш SSL-сертификата, используемого сервером. Возвращается: при успешном выполнении Пример: `"005930BD42F4869B81150A81B3B922F839412CC7"`
certificate_store_name string	Имя локального хранилища SSL-сертификата. Возвращается: при успешном выполнении Пример: `"MY"`
hostname string	Имя узла (DNS) в привязке веб-сайта. Возвращается: при успешном выполнении Пример: `"iis_website.com"`
ip string	IP-адрес прослушивания в привязке веб-сайта. Возвращается: при успешном выполнении Пример: `"127.0.0.1"`
port integer	Порт прослушивания в привязке веб-сайта. Возвращается: при успешном выполнении Пример: `80`
protocol string	Протокол, используемый веб-сайтом. Возвращается: при успешном выполнении Пример: `"http"`
use_ccs string	Использовать централизованное хранилище сертификатов (CCS) для SSL-сертификатов. Возвращается: при успешном выполнении Пример: `"true"`
use_sni boolean	Требовать указание имени сервера (SNI) для SSL-сертификатов. Возвращается: при успешном выполнении Пример: `true`
name string	Имя веб-сайта. Возвращается: при успешном выполнении Пример: `"Default Web Site"`
physical_path string	Указывает физический путь к папке веб-сайта. Возвращается: при успешном выполнении Пример: `"C:\\inetpub\\wwwroot"`
site_id integer	Указывает идентификатор веб-сайта. Возвращается: при успешном выполнении Пример: `1`
state string	Указывает состояние веб-сайта: запущен или остановлен. Возвращается: при успешном выполнении Пример: `"Started"`

Авторы

Shahar Golshani (@sgolshan)

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

© 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/microsoft/iis/website_info_module.html