---
title: VMware Guest Find
slug: homologacao-atmosphere/vmware-guest-find
description: Learn how to use the "vmware_guest_find" module to easily locate the folder path of a virtual machine in your VMware environment. This comprehensive document includes step-by-step instructions, examples, and the values returned by the module. Please note 
docTags: 
createdAt: 2023-03-17T12:36:21.000Z
---

## Resumo

- Encontre o(s) caminho(s) da pasta para uma máquina virtual por nome ou UUID.



## Parâmetros

| **Parâmetro**       | **Tipo** | **Escolhas \| *****Valor Padrão*** | **Comentários**                                                                                                                                                        |
| ------------------- | -------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name                | string   | ******                                  | - Nome da VM com a qual trabalhar.
- Isso é necessário se o parâmetro C(uuid) 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. |
| use\_instance\_uuid | bool     | - ***False***
- True                    | * Se deve usar o UUID da instância VMware em vez do UUID do BIOS.                                                                                                      |

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: Find Guest's Folder using name
  vmware_guest_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    name: testvm
  delegate_to: localhost
  register: vm_folder

- name: Find Guest's Folder using UUID
  vmware_guest_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    uuid: 38c4c89c-b3d7-4ae6-ae4e-43c5118eae49
  delegate_to: localhost
  register: vm_folder

```

## Valores Retornados

| **Chave** | **Tipo** | **Retornado quando** | **Descrição**                                                          |
| --------- | -------- | -------------------- | ---------------------------------------------------------------------- |
| folders   | list     | sucesso              | Lista de pastas para a máquina virtual especificada pelo usuário<br /> |