---
title: Vmware DVS Portgroup Find
slug: homologacao-atmosphere/vmware-dvs-portgroup-find
description: Discover portgroups based on various criteria using this script. Find portgroups by distributed vSwitch, VLAN ID, or string. Learn about the parameters required, such as vSwitch name, hostname, password, port number, proxy settings, and VLAN ID. This docu
docTags: 
createdAt: 2021-12-10T12:28:09.000Z
---

## Sinopse

- Encontrar porgroup(s) baseados em criterios diferentes. Exemplos:  vSwitch distribuidos, VLAN id, ou por string.

## Parâmetros

| **Parâmetro**   | **Tipo** | **Escolhas \| *****Valor Padrão*** | **Comentários**                                                                                                                                                                                                                                                                                                                                                 |
| --------------- | -------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| dvswitch        | string   |                                         | Nome do vSwitch distribuido para a pesquisa                                                                                                                                                                                                                                                                                                                     |
| hostname <br /> | string   |                                         | O nome do host ou endereço IP do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_HOST` será usado em seu lugar.                                                                                                                                                                 |
| name            | string   |                                         | Nome do datastore que corresponda.<br /><br />Se fornecido, informações especificas dos datastores são retornadas                                                                                                                                                                                                                                               |
| password        | string   |                                         | A senha do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PASSWORD` será usado em seu lugar.                                                                                                                                                                                   |
| port            | integer  | ***443***                               | O número da porta do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PORT` será usado em seu lugar.                                                                                                                                                                             |
| proxy\_host     | string   |                                         | Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.<br /><br />O formato é um nome de host ou IP.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_HOST` será usado em seu lugar.<br /><br />Este recurso depende de uma versão do pyvmomi superior a v6.7.1.2018.12           |
| proxy\_port     | integer  |                                         | Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_PORT` será usado em seu lugar.                                                                                                                                                         |
| show\_uplink    | boolean  | - ***False***&#x20;
- True              | Mostrar ou esconder uplink dos portgroups.<br />Relevante somente quando `VLANID`é forncecido                                                                                                                                                                                                                                                                   |
| username        | string   |                                         | O nome de usuário do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_USER`será usado em seu lugar.                                                                                                                                                                                          |
| 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 |
| vlanid          | integer  |                                         | VLAN id, pode ser um número entre 1 e 4094.<br />Esse criterio da pesquisa vai procurar na faixa de alcance da VLAN para achar possiveis correspondentes.                                                                                                                                                                                                       |

## 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: Get all portgroups in dvswitch vDS
  vmware_dvs_portgroup_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    dvswitch: 'vDS'
  delegate_to: localhost

- name: Confirm if vlan 15 is present
  vmware_dvs_portgroup_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    vlanid: '15'
  delegate_to: localhost
```

## Valores Retornados

| **Chave**       | **Tipo**               | **Retornado quando** | **Descrição**                            |
| --------------- | ---------------------- | -------------------- | ---------------------------------------- |
| dvs\_portgroups | list / elements=string | on success           | Detalhes básicos do portgroup encotrados |