This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRDownloadBackup

Short Description

Downloads backup files from the capacity tier to the performance tier.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Start-VBRDownloadBackup -Backup <CBackup[]> [-AllBackup [<SwitchParameter>]] [-RunAsync [<SwitchParameter>]] [-Force [<SwitchParameter>]] [<CommonParameters>]

Detailed Description

This cmdlet downloads backup files from the capacity tier to the performance tier. You can download either all backup files or only the backup files from the latest backup chain.

Important

This cmdlet is available starting from the Veeam Backup & Replication version 10a (build number 10.0.1.4854).

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Backup

Specifies an array of backups which files you want to download to the performance tier. The cmdlet will either download backup files from the latest backup chain or all backup files that are located on the capacity tier.

Default: Downloads backup files from the latest backup chain.

Note: If the backup files from the latest backup chain are already downloaded to the performance tier, the cmdlet will download all backup files from the capacity tier.

Accepts the CBackup[] object. To get this object, run the Get-VBRBackup cmdlet.

True

Named

True (ByValue, ByPropertyName)

AllBackup

Defines that the cmdlet will download all backup files from capacity tier to the performance tier.

Note: If you do not provide this parameter, the cmdlet will download the backup files from the latest backup chain.

SwitchParameter

False

Named

False

RunAsync

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

SwitchParameter

False

Named

False

Force

Defines that the cmdlet will start to download the backup files from the latest backup chain and will not prompt any notifications.

Note:

  • If the performance tier already contains the backup files from the latest backup chain, the cmdlet will not download any backup files from the capacity tier.
  • If you provide the AllBackup parameter, the cmdlet will download all backup files from the capacity tier to the performance tier.

SwitchParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

VBRSession.

Examples

Start-VBRDownloadBackupExample 1. Downloading Backup Files from Latest Backup Chain to Performance Tier

Start-VBRDownloadBackupExample 2. Downloading all Backup Files to Performance Tier

Related Commands

Get-VBRBackup