ANSIBLE.VIRT(3)                 ANSIBLE MODULES                ANSIBLE.VIRT(3)



NAME
       virt - Manages virtual machines supported by libvirt

DESCRIPTION
       Manages virtual machines supported by libvirt.

OPTIONS
       command
              in addition to state management, various non-idempotent commands
              are available. See examples

       name   name of the guest VM being managed(required)

       state  Note that there may be some lag for state requests like shutdown
              since these refer only to VM states. After starting a guest, it
              may not be immediately accessible.  Choices:
              running,shutdown,destroyed,undefined. (default: no)."

NOTES
       Other non-idempotent commands are: status, pause, unpause, get_xml,
       autostart, freemem, list_vms, info, nodeinfo, virttype

EXAMPLES
       Example from Ansible Playbooks

       virt: guest=alpha state=running

       Example guest management with /usr/bin/ansible

       ansible host -m virt -a "guest=alpha command=status"

AUTHOR
       Michael DeHaan, Seth Vidal

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#virt



0.9                               2012-11-30                   ANSIBLE.VIRT(3)
