community.vmware.vmware_guest_storage_policy 模块 – 设置虚拟机主磁盘和磁盘(s) 存储策略配置文件。

注意

此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。

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

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

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

概要 

此模块可用于在虚拟机上对每个磁盘和/或虚拟机主磁盘强制执行存储策略配置文件。

参数 

参数	注释
disk 列表 / 元素=字典	要强制执行存储策略配置文件的磁盘列表。至少需要 `disk` 和 `vm_home` 参数之一。
controller_number 整数	SCSI 控制器编号。有效值范围为 0 到 3。默认值： `0`
policy 字符串 / 必需	要对磁盘强制执行的存储策略配置文件的名称。
unit_number 整数 / 必需	磁盘单元编号。有效值范围为 0 到 15。
folder 字符串	目标文件夹，查找现有客户机的绝对或相对路径。如果找到多个名称相同的虚拟机，则此参数为必需参数。文件夹应包含数据中心。ESX 的数据中心是 ha-datacenter。示例 folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果任务中未指定该值，则将改为使用环境变量 `VMWARE_HOST` 的值。
moid 字符串	如果已知，则为要管理的实例的管理对象 ID，这仅是单个 vCenter 实例中的唯一标识符。需要 `name`、`uuid` 或 `moid` 之一来定义虚拟机。
name 字符串	虚拟机的名称。需要 `name`、`uuid` 或 `moid` 之一来定义虚拟机。
password 别名：pass、pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。如果任务中未指定该值，则将改为使用环境变量 `VMWARE_PASSWORD` 的值。
port 整数	vSphere vCenter 或 ESXi 服务器的端口号。如果任务中未指定该值，则将改为使用环境变量 `VMWARE_PORT` 的值。默认值： `443`
proxy_host 字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。格式为主机名或 IP。如果任务中未指定该值，则将改为使用环境变量 `VMWARE_PROXY_HOST` 的值。
proxy_port 整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。如果任务中未指定值，则将使用环境变量`VMWARE_PROXY_PORT`的值。
用户名别名：admin，user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果任务中未指定值，则将使用环境变量`VMWARE_USER`的值。
UUID 字符串	虚拟机的 UUID。需要 `name`、`uuid` 或 `moid` 之一来定义虚拟机。
validate_certs 布尔值	允许在SSL证书无效时连接。当证书不受信任时，设置为`false`。如果任务中未指定值，则将使用环境变量`VMWARE_VALIDATE_CERTS`的值。选项 `false` `true` ← (默认)
vm_home 字符串	要设置在虚拟机主目录上的存储配置文件策略。至少需要一个`disk` 或 `vm_home` 参数。

备注 

注意

所有模块都需要 API 写入访问权限，因此在免费的 ESXi 许可证上不支持。
所有变量和 VMware 对象名称都区分大小写。

示例 

- name: Enforce storepol1 policy for disk 0 and 1 on SCSI controller 0 using UUID
  community.vmware.vmware_guest_storage_policy:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    uuid: cefd316c-fc19-45f3-a539-2cd03427a78d
    disk:
      - unit_number: 0
        controller_number: 0
        policy: storepol1
      - unit_number: 1
        controller_number: 0
        policy: storepol1
  delegate_to: localhost
  register: policy_status

- name: Enforce storepol1 policy for VM Home using name
  community.vmware.vmware_guest_storage_policy:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    name: hostname1
    vm_home: storepol1
  delegate_to: localhost

返回值 

公共返回值已在此处记录，以下是此模块特有的字段

键	描述
changed_policies 字典	包含磁盘（字典列表）和 vm_home 的已更改策略的字典。返回：始终示例： `{"disk": [{"policy": "storepol1", "unit_number": 0}], "vm_home": "storepol1"}`
msg 字符串	关于作业结果的信息消息。返回：始终示例： `"Policies successfully set."`

作者

Tyler Gates (@tgates81)