Модуль community.windows.win_disk_image — управление монтированием ISO/VHD/VHDX на узлах Windows

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

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

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

Управляет поведением монтирования указанного образа ISO, VHD или VHDX на узле Windows. Если state равно present, образ будет смонтирован с назначенной системой буквой диска, которая будет возвращена в значении mount_path результата модуля.
Требуется Windows 8+ или Windows Server 2012+.

Параметры

Параметр	Комментарии
image_path строка / обязательный	Путь к образу ISO, VHD или VHDX на целевом узле Windows (файл не может находиться в сетевой папке)
state строка	Должен ли образ быть смонтирован как диск с буквой или нет. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примеры

# Run installer from mounted ISO, then unmount
- name: Ensure an ISO is mounted
  community.windows.win_disk_image:
    image_path: C:\install.iso
    state: present
  register: disk_image_out

- name: Run installer from mounted ISO
  ansible.windows.win_package:
    path: '{{ disk_image_out.mount_paths[0] }}setup\setup.exe'
    product_id: 35a4e767-0161-46b0-979f-e61f282fee21
    state: present

- name: Unmount ISO
  community.windows.win_disk_image:
    image_path: C:\install.iso
    state: absent

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

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

Ключ	Описание
mount_paths список / элементы=строка	Список путей файловой системы, смонтированных из целевого образа. Возвращается: когда `state` равно `present` Пример: `["E:\\", "F:\\"]`

Авторы

Matt Davis (@nitzmahone)

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

© 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_disk_image_module.html