The start-VBExport
command initiates the launch of a virtual export from the selected recovery point to an Oracle VirtualBox server virtual machine.
Required parameters include the name of the protected machine containing recovery points to export; the name of the virtual machine you are exporting to; the amount of RAM to be allocated on the virtual machine; the host name and port of the Linux server host, and the path to the local, network, or Linux folder where the resulting virtual machine files will be stored.
Usage
The usage for the command is as follows:
Start-VBExport -core -user [user name] -password [password] -protectedserver [machine name] or [IP address]] -volumes [volume names] -rpn [number | numbers] | -time [time string] -vmname [virtual machine name] [-ram [total megabytes] | -usesourceram] -linuxhostname [linux hostname] -hostport [linux port] -targetpath [location] pathusername [user name] - pathpassword [password]
Command Options
The following table describes the options available for the Start-
VBExport
command:
Option | Description |
---|---|
-? |
Display this help message. |
-core |
Optional. Remote Core host machine IP address (with an optional port number). By default the connection is made to the Core installed on the local machine. |
-user |
Optional. User name for the remote Core host machine. If you specify a user name, you also have to provide a password. If none are provided, then the logged-on user's credentials will be used. |
-password |
Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a user name. If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Protected machine with recovery points to be exported. |
-volumes |
Optional. List of volume names to be exported. If not specified, all volumes in the specified recovery points will be exported. Values must be enclosed in double quotes, each separated by a space. do not use trailing slashes in volume names. For example, specify “C:” not “C:/” |
-rpn |
Optional. The sequential number of a recovery point to be exported. (You can use the Get-RecoveryPoints command to obtain recovery point numbers.)
Note: If neither ‘time’ nor ‘rpn’ option is specified in this command, than the most recent recovery point will be exported. |
-time |
Optional. Determines recovery point to be selected for export. You need to specify exact time in the format “MM/DD/YYYY hh:mm tt” (for example: “04/24/2015 09:00 AM”).” Specify date time values of the time zone set on your local machine.
Note: If neither ‘time’ nor ‘rpn’ option is specified in this command, than the most recent recovery point will be exported. |
-vmname |
Windows name of the virtual machine. |
-ram |
Allocate specific amount of RAM on the virtual server. |
-usesourceram |
Optional. Allocate the same amount of RAM on the virtual server as the source protected machine. |
-linuxhostname |
Linux VirtualBox server hostname. |
-hostport |
Linux VirtualBox server port. |
-targetpath |
Local or network or Linux path to the folder where the virtual machine files are to be stored. |
-pathusername |
User name for network machine. Only required when you specify network path in parameter -targetpath . |
-pathpassword |
Password for network machine. Only required when you specify network path in parameter -targetpath . |
-accountusername |
Optional. Use if you can specify a user account to register the exported virtual machine. For local or network machine only. |
-accountpassword |
Optional. Use only when you specify a user account to register the exported virtual machine using parameter -accountusername. For local or network machine only. |
Example:
Export all volumes from the latest recovery point on machine 10.10.12.97 to a VM called NewVirtualBoxVM:
>Start-VBExport -protectedserver 10.10.12.97 -vmname NewVirtualBoxVM -ram usesourceram -targetpath D:/exports