---
title: Vmware Guest Tools Wait
slug: homologacao-atmosphere/vmware-guest-tools-wait
description: Learn how to use a module to wait for VMWare tools availability in a virtual machine (VM) and retrieve essential facts. This document covers parameters like datacenter, folder, moid, name, name_match, timeout, use_instance_uuid, validate_certs, and uuid. 
docTags: 
createdAt: 2021-12-10T12:28:09.000Z
---

## Sinopse

- Esse módulo pode ser usado para esperar que o VMWare tools esteja disponível em uma dada VM e retornar os facts.

## Parâmetros

| **Parâmetro**        | **Tipo** | **Escolhas \| *****Valor Padrão*** | **Comentários**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | -------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| datacenter           | string   |                                         | O nome do datacenter para o qual coletar informações.<br /><br />Caso não seja fornecido, reunirá informações sobre todos os datacenters do VMware infra.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| folder               | string   |                                         | Pasta de destino, caminho relativo ou absoluto para encontrar um guest existente.<br />Esse parâmetro é requerido somente se multiplas VMs com o mesmo `NAME` forem encontradas.<br />A pasta deve ser incluida no datacenter.<br />ESX's datacenter é `HA-DATACENTER`.<br />Exemplos:<br />folder:/ha-datacenter/vm<br />folder: ha-datacenter/vm<br />folder: /datacenter1/vm<br />folder: datacenter1/vm<br />folder: /datacenter1/vm/folder1<br />folder: datacenter1/vm/folder1<br />folder: /folder1/datacenter1/vm<br />folder: folder1/datacenter1/vm<br />folder: /folder1/datacenter1/vm/folder2 |
| moid                 | string   |                                         | ID do objeto gerenciado da instância a ser gerenciado, se conhecido, é um identificador exclusivo apenas em uma única instância do vCenter. Requerido se uuid ou nome não for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| name                 | string   |                                         | Nome do datastore que corresponda.<br /><br />Se fornecido, informações especificas dos datastores são retornadas                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| name\_match          | string   | - ***First***
- Last                    | Caso haja várias VMs correspondentes ao nome, este parâmetro define se será utilizada a primeira ou a última encontrada.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| timeout              | interger | ***500***                               | Duração máxima do período de espera                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| use\_instance\_uuid  | boolean  | * ***False***&#x20;
* True              | Se deve usar o UUID da instância do VMware em vez do UUID do BIOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| validate\_certs      | boolean  | -  False
- ***True***                   | Permite a conexão quando os certificados SSL não são válidos. Definido para falsequando os certificados não são confiáveis.Se o valor não for especificado na tarefa, o valor da variável de ambiente   `VMWARE_VALIDATE_CERTS` será usado em seu lugar.<br />Se definido como true, certifique-se de que Python> = 2.7.9 esteja instalado na máquina fornecida                                                                                                                                                                                                                                            |
| uuid                 | string   |                                         | UUID da instância a ser gerenciada, se conhecido, é o UUID do BIOS da VMware por padrão.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

## Notas

- Testado em vSphere 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: Wait for VMware tools to become available by UUID
  vmware_guest_facts:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter }}"
    folder: "/{{datacenter}}/vm"
    name: "{{ vm_name }}"
  delegate_to: localhost
  register: vm_facts

- name: Get UUID from previous task and pass it to this task
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    uuid: "{{ vm_facts.instance.hw_product_uuid }}"
  delegate_to: localhost
  register: facts


- name: Wait for VMware tools to become available by MoID
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    moid: vm-42
  delegate_to: localhost
  register: facts

- name: Wait for VMware tools to become available by name
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    name: test-vm
    folder: "/{{datacenter}}/vm"
    datacenter: "{{ datacenter }}"
  delegate_to: localhost
  register: facts

```

## Valores Reornados

| **Chave** | **Tipo** | **Retornado quando** | **Descrição**       |
| --------- | -------- | -------------------- | ------------------- |
| instance  | dict     | sempre               | Metadata sobre a VM |