community.vmware.vmware_guest_tools_info – Сбор информации о VMware Tools, установленных в ВМ

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Для использования в плейбуке укажите: community.vmware.vmware_guest_tools_info.

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

Сбор информации об установленных в виртуальной машине VMware Tools.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.7
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datacenter строка		Имя центров обработки данных, к которому принадлежит виртуальная машина.
folder строка		Папка назначения, абсолютный или относительный путь для поиска существующего гостевого виртуального сервера. Требуется, если указано имя. Папка должна включать центр обработки данных. Центр обработки данных сервера 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 строка		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
moid строка		Идентификатор управляемого объекта экземпляра для управления, если известен. Это уникальный идентификатор только внутри одного экземпляра vCenter. Требуется, если `name` или `uuid` не указаны.
name строка		Имя ВМ для получения информации о VMware Tools. Требуется, если `uuid` или `moid` не указаны.
name_match строка	Варианты: first ← last	Если несколько ВМ соответствуют имени, используется первая или последняя найденная.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PROXY_PORT`.
use_instance_uuid логическое	Варианты: нет ← да	Использовать UUID экземпляра VMware, а не BIOS UUID.
username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
uuid строка		UUID экземпляра для управления, если известен. Это уникальный идентификатор VMware. Требуется, если `name` или `moid` не указаны.
validate_certs логическое	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false` при недоверенности сертификатов. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено `true`, убедитесь, что на указанной машине установлен Python >= 2.7.9.

Примечания

Примечание

Проверено на vSphere 6.0, 6.5, 6.7

Примеры

- 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': None, 'vm_name': 'test_vm', 'vm_tools_install_status': 'toolsOk', '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': None}

Авторы

Diane Wang (@Tomorrow9) <dianew@vmware.com>

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_guest_tools_info_module.html