ansible.vbox_facts(3) - Linux man page

Name

vbox_facts - Gather facts for a guest on VirtualBox

Description

This module gathers facts for a specific guest on a VirtualBox host. These facts include hardware and network related information useful for provisioning (e.g. macaddress, uuid).

This module requires the vboxapi python module.

Options

method The connection method to access the VirtualBox host. Choices: MSCOM,WEBSERVICE,XPCOM. (default: XPCOM) host The VirtualBox host the virtual server is located on.
password: The password to authenticate on the VirtualBox host.
login The login name to authenticate on the VirtualBox host. guest The virtual server to gather facts for on the VirtualBox host.(required)."

Notes

This module ought to be run from a system that can access a VirtualBox host directly. Either by using local_action, or using delegate_to.

Examples

local_action: vbox_facts guest=$inventory_hostname_short
only_if: "'$cmdb_hwmodel'.startswith('VirtualBox')"

[{'hw_processor_count': 1, 'hw_state': 'Saved', 'hw_version': '2', 'hw_firmware': 'EFI', 'hw_chipset': 'PIIX3', 'hw_memtotal_mb': 512, 'hw_ostype': 'RedHat_64', 'hw_uuid': '7af47453-939b-4d42-9fc9-3feb229a92b5', 'hw_description': 'Test system for QA', 'module_hw': True, 'hw_eth0': [{'macaddress': '08:00:27:1B:79:C1', 'connected': True, 'macaddress_dash': '08-00-27-1B-79-C1', 'label"': 'intnet', 'type': 'Internal', 'adaptertype': 'Virtio'}], 'hw_eth1': [{'macaddress': '08:00:27:9A:3C:45', 'connected': True, 'macaddress_dash': '08-00-27-9A-3C-45', 'type': 'NAT', 'adaptertype': 'Virtio', 'label': ''}], 'hw_product_uuid': '7af47453-939b-4d42-9fc9-3feb229a92b5'}]

Author

Dag Wieers