VMware Host Powerstate
Sinopse
- Este módulo pode ser usado para definir o estado de energia (lisga/desliga) de um sistema na infraestrutura do vCenter.
- Usuário pode definir o estado de energia para: ‘power-down-to-standby’, ‘power-up-from-standby’, ‘shutdown-host’ e ‘reboot-host’.
Os estados ‘reboot-host’, ‘shutdown-host’ e ‘power-down-to-standby’ não são suportados por todos os sistemas.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
cluster_name | string
| | Nome do cluster do qual todos os sistemas vão ser usados. Esse parâmetro é requerido se ESXI_HOSTNAME não for fornecido. |
esxi_hostname | string
| | Nome do sistema do host. Esse parâmetro é requerido se CLUSTER_NAME não for fornecido. |
force | boolean
|
| Esse parâmetro especifica se o host deve proceder com estado de energia definido do sistema independente se está no modo de manutenção. Se o STATE está em REBOOT-HOST e FORCE comoTRUE, então o sistema é rebootado independente se está no modo de manutenção. Se o STATE está em SHUTDOWN-HOST e FORCE como TRUE, então o sistema é rebootado independente se está no modo de manutenção. Se o STATE está em POWER-DOWN-TO-STANDBY e FORCE como TRUE, então todos as VMs desligadas serão evacuadas. Não aplicável se STATE está emPOWER-UP-FROM-STANDBY. |
state | string |
| Define o estado do sistema do host. |
timeout | integer | 600 | Esse parâmetro define um temporizador para o STATE em POWER-DOWN-TO-STANDBY ou POWER-UP-FROM-STANDBY. Ignorado se STATEestiver como REBOOT-HOST ou SHUTDOWN-HOST. Esse parâmetro é definido em segundos. |
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
- name: Set the state of a host system to reboot
vmware_host_powerstate:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
state: reboot-host
delegate_to: localhost
register: reboot_host
- name: Set the state of a host system to power down to standby
vmware_host_powerstate:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
state: power-down-to-standby
delegate_to: localhost
register: power_down
- name: Set the state of all host systems from cluster to reboot
vmware_host_powerstate:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: '{{ cluster_name }}'
state: reboot-host
delegate_to: localhost
register: reboot_hostValores Reornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
result | dict | Sempre | Informações sobre o estado do sistema do host |