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 <<< <apeiron@cpan.org> >>>
Copyright (c) 2008 Christopher Nehren (<<< <apeiron@cpan.org> >>>). All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic and perlgpl.
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.
To install VirtualBox::Machine, copy and paste the appropriate command in to your terminal.
cpanm
cpanm VirtualBox::Machine
CPAN shell
perl -MCPAN -e shell install VirtualBox::Machine
For more information on module installation, please visit the detailed CPAN module installation guide.