New in version 2.4.
The below requirements are needed on the host that executes this module.
Parameter |
Choices/Defaults |
Comments |
---|---|---|
datacenter
required |
|
Destination datacenter for the find operation.
Deprecated in 2.5, will be removed in 2.9 release.
|
hostname
required |
|
The hostname or IP address of the vSphere vCenter.
|
name
|
|
Name of the VM to work with.
This is required if uuid is not supplied.
|
password
required |
|
The password of the vSphere vCenter.
aliases: pass, pwd |
port
(added in 2.5) |
Default:
443
|
The port number of the vSphere vCenter or ESXi server.
|
username
required |
|
The username of the vSphere vCenter.
aliases: user, admin |
uuid
|
|
UUID of the instance to manage if known, this is VMware's BIOS UUID.
This is required if name is not supplied.
|
validate_certs
|
True
|
Allows connection when SSL certificates are not valid. Set to false when certificates are not trusted.
|
- name: Find Guest's Folder using name
vmware_guest_find:
hostname: 192.168.1.209
username: administrator@vsphere.local
password: vmware
validate_certs: no
name: testvm
register: vm_folder
- name: Find Guest's Folder using UUID
vmware_guest_find:
hostname: 192.168.1.209
username: administrator@vsphere.local
password: vmware
validate_certs: no
uuid: 38c4c89c-b3d7-4ae6-ae4e-43c5118eae49
register: vm_folder
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
---|---|---|
folders
list
|
on success |
List of folders for user specified virtual machine
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.