Note
This plugin is part of the community.windows collection.
To install it use: ansible-galaxy collection install community.windows.
To use it in a playbook, specify: community.windows.win_disk_image.
state is present, the image will be mounted under a system-assigned drive letter, which will be returned in the mount_path value of the module result.| Parameter | Choices/Defaults | Comments |
|---|---|---|
| image_path string / required | Path to an ISO, VHD, or VHDX image on the target Windows host (the file cannot reside on a network share) | |
| state string |
| Whether the image should be present as a drive-letter mount or not. |
# 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
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| mount_paths list / elements=string | when state is present
| A list of filesystem paths mounted from the target image. Sample: ['E:\\', 'F:\\'] |
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_disk_image_module.html