--- title: VMware Guest Network slug: homologacao-atmosphere/vmware-guest-network description: Learn how to use the VMware Guest Network module to effortlessly add, reconfigure, and remove network adapters from virtual machines. Discover the extensive range of parameters and subfields available for configuring network adapters, including options fo docTags: createdAt: 2021-12-14T12:52:30.000Z --- ## Resumo - Este módulo é usado para adicionar, reconfigurar e remover o adaptador de rede de determinada máquina virtual. ## Parâmetros | **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentarios** | | ---------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cluster  | string | | Nome do cluster ao qual a VM pertence.
| | connected  | boolean | Escolhas:
- false
- true
(default) | Se a NIC deve ser conectada à rede. | | datacenter  | string | "ha-datacenter"
(default) | Datacenter ao qual a VM pertence. | | device\_type  | string | Escolhas:
- e1000
- e1000e
- pcnet32
- vmxnet3
(default)
- sriov | Tipo de dispositivo de rede virtual. | | directpath\_io  | boolean | Escolhas:
- false
(default)
- true | Ative o Universal Pass-through (UPT). Compatível apenas com o tipo de dispositivo vmxnet3. | | esxi\_hostname  | string | | Nome de host do host ESXi ao qual a VM pertence.
| | folder  | string | | Localização da pasta de determinada VM, isso só é necessário quando há várias VMs com o mesmo nome.
| | force  | boolean | Escolhas:
- false
(default)
- true | Força a criação do adaptador mesmo se um adaptador existente estiver conectado à mesma rede. | | gather\_network\_info  | boolean | Escolhas:
- false
(default)
- true | Retorne informações sobre os adaptadores de rede convidados atuais. | | guest\_control  | boolean | Escolhas:
- false
- true
(default) | Permite o controle do convidado sobre se o dispositivo conectável está conectado. | | label  | string | | Altere o nome do adaptador de rede.
| | mac\_address  | string | | Endereço MAC do NIC que deve ser alterado, se um endereço MAC não for fornecido, um novo nic será criado. Requerido quando state = absent.
| | 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 da máquina virtual. Obrigatório se uuid ou moid não for fornecido.
| | network\_name  | string | | Nome da rede no vSphere.
| | networks 
(Possiveis valores) | list / elements=dictionary | | Lista de adaptadores de rede. MAC ou label ou device\_type é necessário para reconfigurar ou remover um adaptador de rede existente. Se houver vários adaptadores de rede com o mesmo device\_type, você deve definir label ou mac para corresponder a um deles, ou irá aplicar alterações em todos os adaptadores de rede com o device\_type especificado.
| | start\_connected  | boolean | Escolhas:
- false
- true
(default) | Se a NIC deve ser conectada à rede na inicialização. | | state  | string | Escolhas:
- present
(default)
- absent | Quando state for present, um nic será adicionado se um endereço mac ou label não existir anteriormente ou não estiver definido. Quando state for absent, o parâmetro mac\_address deve ser definido.
| | switch  | string | | Nome do switch (dv) para a rede de destino, isso só é necessário para dvswitches.
| | use\_instance\_uuid  | boolean | Escolhas:
- false
(default)
- true | Se deve usar o UUID da instância do VMware em vez do UUID do BIOS. | | uuid  | string | | VM uuid. Obrigatório se name ou moid não for fornecido.
| | vlan\_id  | integer | | ID de VLAN associada à rede.
| | wake\_onlan  | boolean | Escolhas:
- false
(default)
- true | Ativar o wake on LAN. | ### Subcampos da opção networks | **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** | | ----------------- | -------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | connected  | boolean | Escolhas:
- false
(default)
- true | Indica que o adaptador de rede virtual se conecta à máquina virtual associada. | | device\_type  | string | Escolhas:
- e1000
- e1000e
- pcnet32
- vmxnet2
- vmxnet3
- sriov | Os tipos de dispositivo de rede virtual válidos são e1000, e1000e, pcnet32, vmxnet2, vmxnet3 (padrão), sriov. Usado para adicionar um novo adaptador de rede, reconfigurar ou remover o adaptador de rede existente com este tipo. Se o mac e o label não forem especificados ou não encontrar o adaptador de rede por mac ou label usará este parâmetro.
| | directpath\_io  | boolean | Escolhas:
- false
(default)
- true | Se definido, Universal Pass-Through (UPT ou DirectPath I / O) será habilitado no adaptador de rede. UPT só é compatível com o adaptador Vmxnet3. | | dvswitch\_name  | string | | Nome do vSwitch distribuído. Este valor é necessário se vários grupos de portas distribuídos existirem com o mesmo nome.
| | label  | string | | Label do adaptador de rede existente a ser reconfigurado ou removido, por exemplo, "Adaptador de rede 1".
| | mac  | string | | Endereço MAC do adaptador de rede existente a ser reconfigurado ou removido.
| | manual\_mac  | string | | Endereço MAC especificado manualmente do adaptador de rede ao criar ou reconfigurar. Se não for especificado ao criar um novo adaptador de rede, o endereço mac será gerado automaticamente. Ao reconfigurar o endereço MAC, a VM deve estar desligada.
| | name  | string | | Nome do grupo de portas ou grupo de portas virtuais distribuído para esta interface. Ao especificar o grupo de portas virtuais distribuídas, certifique-se de que esxi\_hostname ou cluster está associado a ele.
| | start\_connected  | boolean | Escolhas:
- false
(default)
- true | Indica que o adaptador de rede virtual começa com a máquina virtual associada ligada. | | state  | string | Escolhas:
- present
- absent
- new | Estado do adaptador de rede. Se definido como present, fará a reconfiguração do adaptador de rede especificado. Se definido como new, adicionará o adaptador de rede especificado. Se definido como absent, removerá este adaptador de rede.
| | vlan  | integer | | Número da VLAN para esta interface. | Estende fragmentos da documentação do módulo VMware Options. ## Exemplos ```yaml # Exemplo: Mudar de rede para 00:50:56:11:22:33 em vm01.domain.fake - vmware_guest_network: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" name: vm01.domain.fake mac_address: 00:50:56:11:22:33 network_name: admin-network state: present # Exemplo: Adicionar um nic na rede com vlan id 2001 para 422d000d-2000-ffff-0000-b00000000000 - vmware_guest_network: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" uuid: 422d000d-2000-ffff-0000-b00000000000 vlan_id: 2001 # Exemplo: Remover nic com mac 00:50:56:11:22:33 de vm01.domain.fake - vmware_guest_network: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" mac_address: 00:50:56:11:22:33 name: vm01.domain.fake state: absent # Exemplo: Adicione vários nics a vm01.domain.fake - vmware_guest_network: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" name: vm01.domain.fake state: present vlan_id: "{{ item.vlan_id | default(omit) }}" network_name: "{{ item.network_name | default(omit) }}" connected: "{{ item.connected | default(omit) }}" loop: - vlan_id: 2000 connected: false - network_name: guest-net connected: true ``` ## Valores retornados | **Chave** | **Tipo** | **Retornado quando ** | **Descrição** | | -------------- | ---------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | network\_data  | dictionary | Quando gather\_network\_info estiver ativado ou ter passado os parâmetros de network. | Dados sobre os adaptadores de rede da máquina virtual
| | network\_info  | list / elements=string | Sempre | Dados sobre os adaptadores de rede da máquina virtual
|