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

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_disk_image_module.html