The New-VBVirtualStandby
command lets you use PowerShell to create a new virtual export to a VirtualBox virtual machine (VM).
Usage
The usage for the command is as follows:
New-VBVirtualStandby -core [host name] -user [login] -password [password] -protectedserver [name | IP address] -volumes [volumes names] -vmname [virtual machine name] [-ram [total megabytes] | -usesourceram] -linuxhostname [linux hostname] -hostport [linux port] -targetpath [location] -pathusername [login] -pathpassword [password] -initialexport
Command Options
The following table describes the options available for the New-VBVirtualStandby
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 log on.
If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Show jobs for a specific protected machine, indicated by IP address. |
-volumes |
Optional. List the volume names you want to export. If not specified, all volumes in the recovery point(s) are exported. Values must be enclosed in double quotes and separated by space; for example, "c:", "d:".
Note: Do not use trailing slashes in volume names. |
-vmname |
The Microsoft Windows name of the virtual machine. |
-ram |
Allocate a specific amount of RAM on the virtual server. |
-usesourceram |
Optional. Allocate the same amount of RAM on the virtual server that the source protected machine has. |
-linuxhostname |
The Linux VirtualBox server host name. |
-hostport |
The Linux VirtualBox server port. |
-targetpath |
The local, network, or Linux path to the folder where you want to store the virtual machine files. |
-pathusername |
The user name for logging in to the network machine. It is only required when you specify a network location for the target path. |
-pathpassword |
The password for logging in to the network machine. It is only required when you specify a network location for the target path. |
-accountusername |
Optional. You can specify a user account with which to register the exported virtual machine. It is the user name for logging in to the user account. Use this option for a local or network machine only. |
-accountpassword |
Optional. You can specify a user account with which to register the exported virtual machine. It is the password for logging in to the user account. Use this option for a local or network machine only. |
-initialexport |
Optional. Specify this option if you need to start an initial on-demand virtual machine export after configuring the virtual standby. |
Example:
Create a VirtualBox virtual standby machine named ExportedMachine1 in a specified location:
>New-VBVirtualStandby -protectedserver 10.10.10.4 -volumes C:\ -vmname ExportedMachine1 -usesourceram -targetpath I:\VMExport