Using vmware_tools connection plugin


This guide will show you how to utilize VMware Connection plugin to communicate and automate various tasks on VMware guest machines.

Scenario requirements

  • Software

    • Ansible 2.9 or later must be installed.

    • We recommend installing the latest version with pip: pip install Pyvmomi on the Ansible control node (as the OS packages are usually out of date and incompatible) if you are planning to use any existing VMware modules.

  • Hardware

    • vCenter Server 6.5 and above

  • Access / Credentials

    • Ansible (or the target server) must have network access to either the vCenter server

    • Username and Password for vCenter with required permissions

    • VMware tools or openvm-tools with required dependencies like Perl installed on the given virtual machine


  • All variable names and VMware object names are case sensitive.

  • You need to use Python 2.7.9 version in order to use validate_certs option, as this version is capable of changing the SSL verification behaviors.

Example description

User can run playbooks against VMware virtual machines using vmware_tools connection plugin.

In order work with vmware_tools connection plugin, you will need to specify hostvars for the given virtual machine.

For example, if you want to run a playbook on a virtual machine called centos_7 located at /Asia-Datacenter1/prod/centos_7 in the given vCenter, you will need to specify hostvars as follows:


# vmware_tools related variables
ansible_vmware_user=[email protected]

# Location of the virtual machine

# Credentials

Here, we are providing vCenter details and credentials for the given virtual machine to run the playbook on. If your virtual machine path is Asia-Datacenter1/prod/centos_7, you specify ansible_vmware_guest_path as Asia-Datacenter1/vm/prod/centos_7. Please take a note that /vm is added in the virtual machine path, since this is a logical folder structure in the VMware inventory.

Let us now run following playbook,

- name: Example showing VMware Connection plugin
  hosts: centos7
    - name: Gather information about temporary directory inside VM
      shell: ls /tmp

Since Ansible utilizes the vmware-tools or openvm-tools service capabilities running in the virtual machine to perform actions, in this use case it will be connecting directly to the guest machine.

For now, you will be entering credentials in plain text, but in a more advanced playbook this can be abstracted out and stored in a more secure fashion using ansible-vault or using Ansible Tower credentials.

What to expect

Running this playbook can take some time, depending on your environment and network connectivity. When the run is complete you will see:

    "changed": true,
    "cmd": "ls /tmp",
    "delta": "0:00:00.005440",
    "end": "2020-10-01 07:30:56.940813",
    "rc": 0,
    "start": "2020-10-01 07:30:56.935373",
    "stderr": "",
    "stderr_lines": [],
    "stdout": "ansible_command_payload_JzWiL9\niso",
    "stdout_lines": ["ansible_command_payload_JzWiL9", "iso", "vmware-root"]


If your playbook fails:

  • Check if the values provided for username and password are correct.

  • Check if the path of virtual machine is correct. Please mind that /vm/ needs to be provided while specifying virtual machine location.