New in version 2.3.
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. Requires Windows 8+ or Windows Server 2012+.Parameter | Choices/Defaults | Comments |
---|---|---|
image_path required | Path to an ISO, VHD, or VHDX image on the target Windows host (the file cannot reside on a network share) | |
state |
| 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 win_disk_image: image_path: C:\install.iso state: present register: disk_image_out - name: Run installer from mounted iso win_package: path: '{{ disk_image_out.mount_paths[0] }}setup\setup.exe' product_id: 35a4e767-0161-46b0-979f-e61f282fee21 state: present - name: Unmount iso 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_path string | when state is present
| filesystem path where the target image is mounted, this has been deprecated in favour of mount_paths
Sample: F:\ |
mount_paths list | when state is present
| a list of filesystem paths mounted from the target image Sample: ['E:\\', 'F:\\'] |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Core Team, see here.
For more information about Red Hat’s support of this module, please refer to this Knowledge Base article
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_disk_image_module.html