community.vmware.vmware_guest_powerstate 模块 – 管理 vCenter 中虚拟机的电源状态
注意
此模块是 community.vmware 集合（版本 5.2.0）的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install community.vmware。
要在 playbook 中使用它，请指定：community.vmware.vmware_guest_powerstate。
概要
开启/关闭/重启虚拟机。
参数
参数 |
注释 |
|---|---|
在等待任务完成时，如果出现一个或多个问题，则回答问题的列表。 一些常见的用途是允许更改 CD-ROM，即使它被锁定，或者回答虚拟机是复制还是移动的问题。 如果 |
|
消息 ID，例如 |
|
选择键，例如 |
|
要操作电源的虚拟机所在的数据中心。 默认： |
|
目标文件夹，用于查找现有虚拟机的绝对或相对路径。 该文件夹应包含数据中心。ESX 的数据中心是 ha-datacenter 示例 folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2 |
|
忽略警告并完成操作。 此参数在强制虚拟机状态时很有用。 选择
|
|
vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。 如果未在任务中指定该值，则将使用环境变量 |
|
要使用的虚拟机的名称。 vCenter 中的虚拟机名称不一定是唯一的，这可能会有问题，请参阅 |
|
如果多个虚拟机与该名称匹配，则使用找到的第一个或最后一个。 选择
|
|
vSphere vCenter 或 ESXi 服务器的密码。 如果未在任务中指定该值，则将使用环境变量 |
|
将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。 如果任务中未指定该值，则会使用环境变量 |
|
计划任务的描述。 仅当指定了 |
|
指示计划任务是启用还是禁用的标志。 选择
|
|
计划任务的名称。 仅当指定了 |
|
需要执行指定任务的日期和时间，格式为字符串。 日期和时间所需的格式为 ‘dd/mm/yyyy hh:mm’。 计划任务需要 vCenter 服务器。独立的 ESXi 服务器不支持此选项。 |
|
设置虚拟机的状态。 选择
|
|
如果 如果此参数设置为正整数，则模块将等待虚拟机达到关闭状态。 该值设置模块等待状态更改的超时时间，以秒为单位。 默认值： |
|
是否使用 VMware 实例 UUID 而不是 BIOS UUID。 选择
|
|
vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定该值，则会使用环境变量 |
|
当 SSL 证书无效时允许连接。当证书不受信任时，设置为 如果任务中未指定该值，则会使用环境变量 选择
|
备注
注意
所有模块都需要 API 写入权限，因此免费的 ESXi 许可证不支持。
所有变量和 VMware 对象名称都区分大小写。
示例
- name: Set the state of a virtual machine to poweroff
community.vmware.vmware_guest_powerstate:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
folder: "/{{ datacenter_name }}/vm/my_folder"
name: "{{ guest_name }}"
state: powered-off
delegate_to: localhost
register: deploy
- name: Set the state of a virtual machine to poweron using MoID
community.vmware.vmware_guest_powerstate:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
folder: "/{{ datacenter_name }}/vm/my_folder"
moid: vm-42
state: powered-on
delegate_to: localhost
register: deploy
- name: Set the state of a virtual machine to poweroff at given scheduled time
community.vmware.vmware_guest_powerstate:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
folder: "/{{ datacenter_name }}/vm/my_folder"
name: "{{ guest_name }}"
state: powered-off
scheduled_at: "09/01/2018 10:18"
schedule_task_name: "task_00001"
schedule_task_description: "Sample task to poweroff VM"
schedule_task_enabled: true
delegate_to: localhost
register: deploy_at_schedule_datetime
- name: Wait for the virtual machine to shutdown
community.vmware.vmware_guest_powerstate:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
name: "{{ guest_name }}"
state: shutdown-guest
state_change_timeout: 200
delegate_to: localhost
register: deploy
- name: Automatically answer if a question locked a virtual machine
block:
- name: Power on a virtual machine without the answer param
community.vmware.vmware_guest_powerstate:
hostname: "{{ esxi_hostname }}"
username: "{{ esxi_username }}"
password: "{{ esxi_password }}"
validate_certs: false
folder: "{{ f1 }}"
name: "{{ vm_name }}"
state: powered-on
rescue:
- name: Power on a virtual machine with the answer param
community.vmware.vmware_guest_powerstate:
hostname: "{{ esxi_hostname }}"
username: "{{ esxi_username }}"
password: "{{ esxi_password }}"
validate_certs: false
folder: "{{ f1 }}"
name: "{{ vm_name }}"
answer:
- question: "msg.uuid.altered"
response: "button.uuid.copiedTheVM"
state: powered-on