Restore VM

The restore vm command can be used to restore a Microsoft Hyper-V virtual machine that was previously backed up by IBM® Tivoli® Storage Manager for Virtual Environments: Data Protection for Microsoft Hyper-V.

If the virtual machine that you are restoring exists on the Hyper-V host server, it is shut down and deleted before it is restored from the image stored on the Tivoli Storage Manager server. The Restore VM operation then creates the virtual machine such that its content and configuration is identical to what it was when the backup occurred. Even though the client shuts down the virtual machine before deleting it, manually shutting down the virtual machine before running Restore VM is a good practice to bring any in-progress application activities to an orderly stop.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-REStore VM-- --sourcevmspec---------------------------------->

>--+------------------------------------------------+----------->
   '- -vmname=--new_vm_name-- -- -targetpath=--path-'   

>--+------------+----------------------------------------------><
   '- --options-'   

Parameters

Any parameter that contains spaces must be enclosed in quotation (" ") marks.

sourcevmspec
Specifies the name of the virtual machine that was backed up. The virtual machine name is case-sensitive.
-vmname=new_vm_name
Optional. Specifies a new name for the virtual machine. If this parameter is not specified, the virtual machine is restored and it has the same name it had when it was backed up. If you do specify a new name for a virtual machine, a target path is required.
-targetpath=path
Use this parameter to restore the virtual machine to an alterative location on the file system. This parameter is required when you specify the vmname parameter.
Table 1. Restore VM command: Related options when restoring Hyper-V virtual machines
Option Where to use
inactive Command line
pick Command line
pitdate Command line
pittime Command line
vmbackuptype Command line or client options file. To restore a Hyper-V virtual machine, this option must be set to HYPERVFULL.

Examples

Task
Restore the most recent backup version of a virtual machine named myVM.
dsmc restore vm myvm