---
title: VMware Host Auto Start
slug: homologacao-atmosphere/vmware-host-auto-start
description: Learn how to configure automatic startup and shutdown of virtual machines based on host activity with this comprehensive document. It covers essential parameters like ESXi hostname, managed object ID, VM name, power information, system defaults, and the o
docTags:
createdAt: 2022-01-27T12:52:43.000Z
---
## Resumo
- Neste módulo, é possível configurar a inicialização e desligamento automático de máquinas virtuais de acordo com a inicialização ou desligamento do host.
## Parâmetros
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| --------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| esxi\_hostname - *required* | string | | Nome do host ESXi onde existe a VM para definir a ativação ou desativação automática. |
| moid | string | | ID do objeto gerenciado da instância a ser gerenciada, se conhecido, este é um identificador exclusivo apenas em uma única instância do vCenter. Isso será necessário se nome ou uuid não for fornecido. |
| name | string | | Nome da VM para definir a ativação ou desativação automática. Isso não é necessário se alterar apenas as configurações padrão da VM do sistema para a configuração de inicialização automática. |
| power\_info | dictionary | Default:
\{"start\_action": "none", "start\_delay": -1, "start\_order": -1, "stop\_action": "systemDefault", "stop\_delay": -1, "wait\_for\_heartbeat": "systemDefault"} | Configurações de inicialização ou desligamento da máquina virtual. Essa configuração substituirá os padrões do sistema. |
| system\_defaults | dictionary | | Padrões do sistema para configuração de inicialização automática ou parada automática para máquina virtual. |
| use\_instance\_uuid | boolean | Escolhas:
- true
- false
(default) | Se deve ser usado o UUID da instância VMware em vez do UUID do BIOS. |
| uuid | string | | VM uuid para ativar ou desativar a ativação automática, este é o identificador exclusivo do VMware. Isso é necessário se nome não for fornecido. Isso não é necessário se alterar apenas as configurações de VM padrão do sistema para configuração de início automático. |
### Subcampos da opção power\_info
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| -------------------- | -------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| start\_action | string | Escolhas:
- 'none'
(default)
- 'powerOn' | Se deve iniciar a máquina virtual quando a inicialização do host. |
| start\_delay | integer | -1
(default) | Atraso de início automático em segundos da máquina virtual. |
| start\_order | integer | -1
(default) | A prioridade de inicialização automática da máquina virtual. As máquinas virtuais com um número mais baixo são ligadas primeiro. No desligamento do host, as máquinas virtuais são desligadas na ordem inversa, o que significa que aquelas com um número mais alto são desligadas primeiro. |
| stop\_action | string | Escolhas:
- 'none'
- 'systemDefault'
(default)
- 'powerOff'
- 'suspend' | Ação de parada executada na máquina virtual quando o sistema para de máquina virtual. |
| stop\_delay | integer | -1
(default) | Atraso de parada automática em segundos da máquina virtual. |
| wait\_for\_heartbeat | string | Escolhas:
- 'no'
- 'yes'
- 'systemDefault'
(default) | Continue a ligar o processamento quando o VMware Tools for iniciado. |
### Subcampos da opção system\_defaults
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| -------------------- | -------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| enabled | boolean | Escolhas:
- true
- false
(default) | Habilite o início ou a parada automática de máquinas virtuais. |
| start\_delay | integer | 120
(default) | Atraso de início automático padrão em segundos. |
| stop\_action | string | Escolhas:
- 'none'
- 'guestShutdown'
- 'powerOff'
- 'suspend' | Ação de parada padrão executada na máquina virtual quando o sistema para. |
| stop\_delay | integer | 120
(default) | Atraso de parada automática padrão em segundos. |
| wait\_for\_heartbeat | boolean | Escolhas:
- true
- false
(default) | Continue a ligar o processamento quando o VMware Tools for iniciado. Se este parâmetro estiver ativado para ligar a próxima máquina virtual sem esperar que o atraso passe. No entanto, a máquina virtual deve ter o VMware Tools instalado. |
## Exemplos
```yaml
# Exemplo: Atualização para configuração de padrões do sistema.
- vmware_host_auto_start:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
esxi_hostname: "{{ esxi_hostname }}"
system_defaults:
enabled: true
start_delay: 100
stop_action: guestShutdown
stop_delay: 120
wait_for_heartbeat: false
# Exemplo: Atualização para configuração powerInfo da máquina virtual.
- vmware_host_auto_start:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
esxi_hostname: "{{ esxi_hostname }}"
name: "{{ vm_name }}"
power_info:
start_action: powerOn
start_delay: 10
start_order: 1
stop_action: powerOff
wait_for_heartbeat: true
```
## Valores retornados
| **Chave** | **Tipo** | **Retornado quando** | **Descrição** |
| ------------------------- | ---------- | -------------------- | --------------------------------------------------------------------------------------------------- |
| power\_info\_config | dictionary | Modificado | Retorno de parâmetro quando a configuração de informações de energia da máquina virtual é alterada. |
| system\_defaults\_config | dictionary | Modificado | Retorno do parâmetro quando a configuração padrão do sistema é alterada. |