Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Start-VBRRestoreVMFiles

Short Description

Restores VM configuration files.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Start-VBRRestoreVMFiles [-RestorePoint] <COib> [-Server] <CHost> [-Path] <string> [-Files <COIBFileInfo[]>] [-Reason <string>] [-RunAsync] [-Force]  [<CommonParameters>]

Detailed Description

This cmdlet allows you to restore configuration file (.vmx) or virtual disks (.vmdk) of a selected VM.

Run Start-VBRWindowsFileRestore to restore VM disks data.

Starting from Veeam Backup & Replication version 9.5 Update 3, the cmdlet checks if the data of the VM you want to restore changes its geographical location.

Start-VBRRestoreVMFiles Note:

The cmdlet will not run if the geographical location of the repository where VM backups reside and the target host location do not match. If you still want to run the cmdlet, use the Force parameter.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

RestorePoint

Specifies the VM restore point to which you want to restore.

True

1

True (ByValue,
ByProperty
Name)

False

Server

Specifies the host to which the VM guest files should be restored.

True

2

False

False

Path

Specifies the string with the path to the folder where restored files should be saved.

True

3

False

False

Files

Specifies the files you want to restore.

By default, all files from the VM will be restored.

False

Named

True (ByProperty
Name)

False

Reason

Specifies the string with the reason for performing the VM guest OS file restore.

False

Named

False

False

RunAsync

Indicates that the command returns immediately without waiting for the task to complete.

False

Named

False

False

Force

Indicates that the cmdlet will restore VM configuration files even if the location of the repository where VM backups reside and the target host location do not match.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example

This example allows you to restore all VM guest OS files from the restore point specified in the $point variable and save them on the host specified in the $server variable to the C:\BackupFiles folder.

PS C:\PS> Start-VBRRestoreVMFiles –RestorePoint $point –Server $server –Path “C:\BackupFiles”

Related Commands

Get-VBRRestorePoint

Get-VBRServer

Get-VBRFilesInRestorePoint

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Backup Explorers User Guide

Backup and Restore of SQL Server Databases

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation