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.