community.vmware.vmware_guest_tools_info 模块 – 收集虚拟机中已安装 VMware Tools 的信息

注意

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

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

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

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

概要

• 收集有关虚拟机中已安装 VMware Tools 的信息。

参数

参数	注释
datacenter 字符串	虚拟机所属的数据中心名称。
folder 字符串	目标文件夹，查找现有虚拟机的绝对或相对路径。 如果提供了 name，则此参数是必需的。 此文件夹应包含数据中心。ESXi 服务器的数据中心为 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，则此参数是必需的。
name 字符串	要获取 VMware Tools 信息的虚拟机的名称。 如果未提供 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的唯一标识符。 如果未提供name或moid，则需要此参数。
validate_certs 布尔值	允许在SSL证书无效时连接。当证书不受信任时，将其设置为false。 如果任务中未指定值，则将使用环境变量VMWARE_VALIDATE_CERTS的值。 选项 false true ← (默认)

注释

注意

• 所有模块都需要API写入权限，因此在免费ESXi许可证上不支持。

• 所有变量和VMware对象名称都区分大小写。

示例

- name: Gather VMware tools info installed in VM specified by uuid
  community.vmware.vmware_guest_tools_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    uuid: 421e4592-c069-924d-ce20-7e7533fab926
  delegate_to: localhost
  register: vmtools_info

- name: Gather VMware tools info installed in VM specified by name
  community.vmware.vmware_guest_tools_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    name: "{{ vm_name }}"
  delegate_to: localhost
  register: vmtools_info

返回值

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

键

描述

vmtools_info 字典

关于虚拟机中安装的VMware Tools的元数据 返回：始终 示例： {"vm_guest_fullname": "Microsoft Windows 10 (64-bit)", "vm_guest_hostname": "test", "vm_guest_id": "windows9_64Guest", "vm_hw_version": "vmx-14", "vm_ipaddress": "10.10.10.10", "vm_moid": null, "vm_name": "test_vm", "vm_tools_install_type": "guestToolsTypeMSI", "vm_tools_last_install_count": 0, "vm_tools_running_status": "guestToolsRunning", "vm_tools_upgrade_policy": "manual", "vm_tools_version": 10341, "vm_tools_version_status": "guestToolsCurrent", "vm_use_instance_uuid": false, "vm_uuid": null}

作者

• 王黛安 (@Tomorrow9)

资源链接

• 问题跟踪器
• 主页
• 代码库 (源码)