модуль microsoft.iis.virtual_directory – Настройка виртуального каталога в IIS

Примечание

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

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

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

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

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

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

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

Требования

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

Модуль PowerShell IISAdministration

Параметры

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

Атрибуты

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

См. также

microsoft.iis.virtual_directory_info: Получение сведений о виртуальном каталоге в IIS.
microsoft.iis.web_application: Настройка веб-приложений IIS.
microsoft.iis.website: Настройка веб-сайта IIS.

Примеры

- name: Create a virtual directory
  microsoft.iis.virtual_directory:
    name: somedirectory
    site: somesite
    state: present
    physical_path: C:\virtualdirectory\some

- name: Remove a virtual directory
  microsoft.iis.virtual_directory:
    name: somedirectory
    site: somesite
    state: absent

- name: Create a virtual directory on an application
  microsoft.iis.virtual_directory:
    name: somedirectory
    site: somesite
    application: someapp
    state: present
    physical_path: C:\virtualdirectory\some

Авторы

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