Модуль community.windows.win_iis_virtualdirectory – настройка виртуального каталога в IIS

Примечание

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

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

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

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

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

УСТАРЕЛО

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

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

Создает, удаляет и настраивает виртуальный каталог в IIS.

Параметры

Параметр	Комментарии
application string	Приложение, в котором создается или существует виртуальный каталог.
connect_as string добавлено в community.windows 1.9.0	Тип аутентификации, используемый для виртуального каталога. `pass_through` или `specific_user` Если задано `pass_through`, IIS будет использовать для доступа к физическому пути учетные данные пользователя или удостоверение пула приложений. Если задано `specific_user`, IIS будет использовать для доступа к физическому пути учетные данные, указанные в username и password. Варианты: `"pass_through"` `"specific_user"`
name string / обязательный	Имя виртуального каталога, который нужно создать или удалить.
password string добавлено в community.windows 1.9.0	Пароль, соответствующий username. Обязателен, если для connect_as задано значение `specific_user`.
physical_path string	Физический путь к папке, в которой создается новый виртуальный каталог. Указанная папка должна уже существовать.
site string / обязательный	Имя сайта, в котором создается или существует виртуальный каталог.
state string	Добавить или удалить указанный виртуальный каталог. При удалении виртуальный каталог и все вложенные в него элементы удаляются рекурсивно. Варианты: `"absent"` `"present"` ← (по умолчанию)
username string добавлено в community.windows 1.9.0	Имя пользователя учетной записи, которой разрешен доступ к файлам конфигурации и содержимому виртуального каталога. Обязательно, если для connect_as задано значение `specific_user`.

См. также

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

Примеры

- name: Create a virtual directory if it does not exist
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: present
    physical_path: C:\virtualdirectory\some

- name: Remove a virtual directory if it exists
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: absent

- name: Create a virtual directory on an application if it does not exist
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    application: someapp
    state: present
    physical_path: C:\virtualdirectory\some

Статус

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

Авторы

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_virtualdirectory_module.html