community.windows.win_disk_image 模块 – 管理 Windows 主机上的 ISO/VHD/VHDX 挂载

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在剧本中使用它，请指定：community.windows.win_disk_image。

概要

  • 管理 Windows 主机上指定的 ISO、VHD 或 VHDX 映像的挂载行为。当 state 为 present 时，映像将挂载在系统分配的驱动器号下，该驱动器号将以模块结果的 mount_path 值返回。

  • 需要 Windows 8+ 或 Windows Server 2012+。

参数

参数

注释

image_path

字符串 / 必需

目标 Windows 主机上 ISO、VHD 或 VHDX 映像的路径（该文件不能位于网络共享上）

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)