You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

vsphere_copy - Copy a file to a vCenter datastore¶

New in version 2.0.

Synopsis
Options
Examples
Notes
- Status

Synopsis ¶

Upload files to a vCenter datastore

Options ¶

parameter	required	default	choices	comments
datacenter	yes			The datacenter on the vCenter server that holds the datastore.
datastore	yes			The datastore on the vCenter server to push files to.
host	yes			The vCenter server on which the datastore is available.
login	yes			The login name to authenticate on the vCenter server.
password	yes			The password to authenticate on the vCenter server.
path	yes			The file to push to the datastore on the vCenter server.
src	yes			The file to push to vCenter
validate_certs	no	yes	yes no	If `no`, SSL certificates will not be validated. This should only be set to `no` when no other option exists.

Examples ¶

- vsphere_copy:
    host: vhost
    login: vuser
    password: vpass
    src: /some/local/file
    datacenter: DC1 Someplace
    datastore: datastore1
    path: some/remote/file
  transport: local
- vsphere_copy:
    host: vhost
    login: vuser
    password: vpass
    src: /other/local/file
    datacenter: DC2 Someplace
    datastore: datastore2
    path: other/remote/file
  delegate_to: other_system

Notes ¶

Note

This module ought to be run from a system that can access vCenter directly and has the file to transfer. It can be the normal remote target or you can change it either by using transport: local or using delegate_to.
Tested on vSphere 5.5

Status ¶

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.