NAME

       Rex::Virtualization::VBox - VirtualBox Virtualization Module

DESCRIPTION

       With this module you can manage VirtualBox.

SYNOPSIS

        use Rex::Commands::Virtualization;

        set virtualization => "VBox";

        use Data::Dumper;

        print Dumper vm list => "all";
        print Dumper vm list => "running";

        vm destroy => "vm01";

        vm delete => "vm01";

        vm start => "vm01";

        vm shutdown => "vm01";

        vm reboot => "vm01";

        vm option => "vm01",
              memory    => 512;

        print Dumper vm info => "vm01";

        # creating a vm
        vm create => "vm01",
           storage    => [
             {
               file  => "/mnt/data/vbox/vm01.img",
               size  => "10G",
             },
             {
               file => "/mnt/iso/debian6.iso",
             }
           ],
           memory => 512,
           type => "Linux26",
           cpus => 1,
           boot => "dvd";

        vm forward_port => "vm01", add => { http => [8080, 80] };

        vm forward_port => "vm01", remove => "http";

        print Dumper vm guestinfo => "vm01";

        vm share_folder => "vm01", add => { sharename => "/path/to/share" };

        vm share_folder => "vm01", remove => "sharename";

       For VirtualBox memory declaration is always in megabyte.