---
title: VMware Guest TPM
slug: homologacao-atmosphere/vmware-guest-tpm
description: Learn how to add or remove a Virtual Trusted Platform Module (vTPM) device for a virtual machine with this comprehensive document. It covers essential parameters like name, UUID, and managed object ID, along with the vTPM device's state. Discover the prer
docTags: 
createdAt: 2023-03-17T12:36:24.000Z
---

## Resumo

- Este módulo é usado para adicionar ou remover o dispositivo Virtual Trusted Platform Module (vTPM) para um Máquina virtual.



## Parâmetros

| **Parâmetro** | **Tipo** | **Escolhas \| *****Valor Padrão*** | **Comentários**                                                                                                                                                                                                                                                                                                                                                                 |
| ------------- | -------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name          | string   | ******                                  | - Nome da máquina virtual.
- Isso é necessário se o parâmetro C(uuid) ou C(moid) não for fornecido.                                                                                                                                                                                                                                                                             |
| uudi          | string   |                                         | * UUID da instância para gerenciar, se conhecido, este é o identificador exclusivo do VMware.
* Isso é necessário se o parâmetro C(name) ou C(moid) não for fornecido.                                                                                                                                                                                                          |
| moid          | string   |                                         | - ID do objeto gerenciado da instância a ser gerenciada, se conhecida, este é um identificador exclusivo apenas em uma única instância do vCenter.
- Isso é necessário se C(name) ou C(uuid) não for fornecido.                                                                                                                                                                 |
| folder        | string   |                                         | * Pasta VM, caminho absoluto ou relativo para encontrar uma VM existente.
* Este parâmetro não é necessário, apenas quando várias VMs são encontradas com o mesmo nome.
* A pasta deve incluir o nome do datacenter.                                                                                                                                                            |
| datacenter    | string   |                                         | - O nome do datacenter do vCenter usado para obter o cluster ou host especificado.
- Este parâmetro diferencia maiúsculas de minúsculas.                                                                                                                                                                                                                                        |
| state         | string   | * ***present***
* absent                | - Estado do dispositivo vTPM.
- Se definido como 'ausente', o dispositivo vTPM será removido da VM.
- Se definido como 'presente', o dispositivo vTPM será adicionado se não estiver presente.
- A máquina virtual deve ser desligada antes de adicionar ou remover o dispositivo vTPM.
- A máquina virtual não deve conter instantâneos antes de adicionar o dispositivo vTPM. |

Estende fragmentos da documentação do módulo [VMware Options](https://app.archbee.com/docs/qhqZWWA92JYWAihQOL_T5/lUq5eineIhH7ZwvyWZYCa).

## Notas

Observação

- Testado em ESXi 7.0.2
- Todos os módulos requerem acesso de gravação API e, portanto, não são suportados em uma licença ESXi gratuita.

## Exemplos

```yaml
- name: Add vTPM to specified VM
  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
  vmware_guest_tpm:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter }}"
    name: "Test_VM"
    state: absent
  delegate_to: localhost

```

## Valores Retornados

| **Chave** | **Tipo** | **Retornado quando** | **Descrição**                               |
| --------- | -------- | -------------------- | ------------------------------------------- |
| instance  | dict     | sucesso              | metadados sobre o dispositivo VM vTPM<br /> |