Модуль community.vmware.vmware_guest_tpm — добавление или удаление устройства vTPM для указанной виртуальной машины.

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_guest_tpm.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль добавляет или удаляет устройство виртуального доверенного платформенного модуля (vTPM) для существующей виртуальной машины. Перед добавлением vTPM необходимо создать поставщика ключей в vCenter. На хостах ESXi в вашей среде должна быть установлена версия ESXi 6.7 или более поздняя (гостевая ОС Windows) либо 7.0 Update 2 (гостевая ОС Linux).

Параметры

Параметр	Комментарии
datacenter строка / обязательный	Имя центра обработки данных vCenter, используемое для получения указанного кластера или хоста.
folder строка	Папка виртуальной машины — абсолютный или относительный путь для поиска существующей виртуальной машины. Этот параметр необязателен; укажите его, только если обнаружено несколько виртуальных машин с одинаковым именем. Путь к папке должен содержать имя центра обработки данных. Примеры: 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-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_HOST`.
moid строка	Идентификатор управляемого объекта экземпляра, если он известен. Это уникальный идентификатор только в пределах одного экземпляра vCenter. Обязателен, если не указан `name` или `uuid`.
name строка	Имя виртуальной машины. Обязателен, если не указан параметр `uuid` или `moid`.
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет принимать все HTTPS-запросы и перенаправлять их. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет принимать все HTTPS-запросы и перенаправлять их. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_PORT`.
state строка	Состояние устройства vTPM. Если указано значение ‘absent’, устройство vTPM будет удалено из виртуальной машины. Если указано значение ‘present’, устройство vTPM будет добавлено, если оно отсутствует. Перед добавлением или удалением устройства vTPM виртуальную машину необходимо выключить. Перед добавлением устройства vTPM у виртуальной машины не должно быть снимков состояния. Варианты: `"present"` ← (по умолчанию) `"absent"`
username псевдонимы: admin, user строка	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_USER`.
uuid строка	UUID экземпляра, если он известен. Это уникальный идентификатор VMware. Обязателен, если не указан параметр `name` или `moid`.
validate_certs логическое значение	Разрешает подключение при недействительных сертификатах SSL. Если сертификатам нельзя доверять, задайте значение `false`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей необходим доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не обращается к системному хранилищу сертификатов. Указать хранилище сертификатов можно с помощью переменной среды REQUESTS_CA_BUNDLE. Обратите внимание: в некоторых случаях, если эта переменная задана, значение ‘false’ для параметра ‘validate_certs’ может игнорироваться. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Add vTPM to specified VM
  community.vmware.vmware_guest_tpm:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter }}"
    name: "Test_VM"
    state: present
  delegate_to: localhost

- name: Remove vTPM from specified VM
  community.vmware.vmware_guest_tpm:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter }}"
    name: "Test_VM"
    state: absent
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
instance словарь	метаданные об устройстве vTPM виртуальной машины Возвращается: всегда Пример: `"None"`

Авторы

Diane Wang (@Tomorrow9)

Ссылки на коллекцию

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