community.vmware.vmware_guest_boot_info 模块 – 收集给定虚拟机的启动选项信息

注意

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

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

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

要在 playbook 中使用它，请指定： community.vmware.vmware_guest_boot_info。

概要 

收集给定虚拟机的启动选项信息。

参数 

参数	注释
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果未在任务中指定该值，则将改用环境变量 `VMWARE_HOST` 的值。
moid 字符串	要管理的实例的托管对象 ID（如果已知），这是单个 vCenter 实例内的唯一标识符。如果未提供 `name` 或 `uuid`，则此参数为必填项。
name 字符串	要使用的虚拟机的名称。如果未提供 `uuid` 或 `moid` 参数，则此参数为必填项。
name_match 字符串	如果多个虚拟机与名称匹配，则使用找到的第一个或最后一个。选项 `"first"` ← (默认) `"last"`
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` 的值。
use_instance_uuid 布尔值	是否使用 VMware 实例 UUID 而不是 BIOS UUID。选项 `false` ← (默认) `true`
username 别名: admin, user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果未在任务中指定该值，则将改用环境变量 `VMWARE_USER` 的值。
uuid 字符串	要管理的实例的 UUID（如果已知），默认为 VMware 的 BIOS UUID。如果未提供 `name` 或 `moid` 参数，则此参数为必填项。
validate_certs 布尔值	允许在 SSL 证书无效时进行连接。当证书不受信任时，设置为 `false`。如果任务中未指定该值，则将使用环境变量 `VMWARE_VALIDATE_CERTS` 的值。选项 `false` `true` ← (默认)

注释 

注意

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

示例 

- name: Gather info about virtual machine's boot order and related parameters
  community.vmware.vmware_guest_boot_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    name: "{{ vm_name }}"
  register: vm_boot_order_info

- name: Gather information about virtual machine's boot order using MoID
  community.vmware.vmware_guest_boot_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    moid: "vm-42"
  register: vm_moid_boot_order_info

返回值 

常见的返回值记录在这里，以下是此模块独有的字段

键	描述
vm_boot_info 字典	关于虚拟机引导顺序的元数据返回：始终示例： `{"current_boot_delay": 2000, "current_boot_firmware": "bios", "current_boot_order": ["floppy", "disk", "ethernet", "cdrom"], "current_boot_retry_delay": 22300, "current_boot_retry_enabled": true, "current_enter_bios_setup": true, "current_secure_boot_enabled": false}`

作者

Abhijeet Kasurde (@Akasurde)