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

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: 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:\\"]`

Авторы

Мэтт Дэвис (@nitzmahone)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_disk_image_module.html