модуль microsoft.iis.virtual_directory_info – Получение информации о виртуальном каталоге в IIS

Примечание

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

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

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

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

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

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

Получение информации о виртуальном каталоге в IIS.

Требования

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

Модуль PowerShell IISAdministration

Параметры

Параметр	Комментарии
application string	Имя веб-приложения IIS, из которого нужно получить виртуальные каталоги. Если параметр не задан, будут возвращены все виртуальные каталоги веб-сайтов.
name string	Имя виртуального каталога, сведения о котором нужно получить. Если параметр не задан, будут возвращены все виртуальные каталоги.
site string	Имя веб-сайта IIS, из которого нужно получить виртуальные каталоги. Если параметр не задан, будут возвращены все виртуальные каталоги веб-сайтов.

Атрибуты

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

См. также

microsoft.iis.virtual_directory: Настраивает виртуальный каталог в IIS.

Примеры

- name: Get information for all virtual directories
  microsoft.iis.virtual_directory_info:
  register: vdir_info

- name: Get information for virtual directory on a specific site
  microsoft.iis.virtual_directory_info:
    site: somesite
    name: somedirectory
  register: vdir_info

- name: Get information for virtual directory on a specific site and application
  microsoft.iis.virtual_directory_info:
    site: somesite
    name: somedirectory
    application: someapplication
  register: vdir_info

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

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

Ключ	Описание
directories list / elements=dictionary	Список найденных виртуальных каталогов. Возвращается: при успешном выполнении Пример: `"[ { \"name\": \"somedirectory\", \"site\": \"Test Site\", \"physical_path\": \"C:\\\\Users\\\\ansibleAdmin\\\\AppData\\\\Local\\\\Temp\\\\ansible.sgivydkm.qid.test\", \"application\": null, \"username\": \"\" } ]"`
application string	Имя приложения, в котором находится виртуальный каталог. Возвращается: при успешном выполнении
name string	Имя виртуального каталога. Возвращается: при успешном выполнении Пример: `"somedirectory"`
physical_path string	Физический путь к виртуальному каталогу. Возвращается: при успешном выполнении Пример: `"C:\\Users\\ansibleAdmin\\AppData\\Local\\Temp\\ansible.sgivydkm.qid.test"`
site string	Имя сайта, в котором находится виртуальный каталог. Возвращается: при успешном выполнении Пример: `"Test Site"`
username string	Имя пользователя для виртуального каталога при использовании аутентификации с учетными данными конкретного пользователя. Возвращается: при успешном выполнении Пример: `""`
exists boolean	Найдены ли виртуальные каталоги. Возвращается: при успешном выполнении Пример: `true`

Авторы

Hen Yaish (@hyaish)

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

© 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/virtual_directory_info_module.html