VirtualBox::Machine -- a VirtualBox virtual machine.
This documentation refers to VirtualBox::Machine version 0.0.0.
use VirtualBox::Manage; use Moose::Autobox; my $vb = VirtualBox::Manage->new($args); my $freebsd = $vb->machines->at('FreebSD'); $freebsd->start; print $freebsd->running ? "It's running!" : "An error slipped past!"; $freebsd->stop; print $freebsd->running ? "An error slipped past!" : "It's not running.";
This class represents a VirtualBox virtual machine. It provides an API for programmatically managing VMs. This includes starting and stopping as well as a collection of accessors for various attributes of the VM.
Read-only attribute denoting the XML configuration file for this machine.
Read-only attribute specifying the UUID for this machine.
Read-only attribute specifying user-friendly name for this machine.
Returns a Boolean describing whether the machine is presently running.
Attempts to start the machine. Dies on failure.
Attempts to stop the machine. Dies on failure.
Christopher Nehren <<< <email@example.com> >>>
Copyright (c) 2008 Christopher Nehren (<<< <firstname.lastname@example.org> >>>). All rights reserved.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.