Download-VBRDeletedArchivedBackupFile

Short Description

Retrieves a backup file deleted from the archive tier and preserved by insider protection.

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides the following parameter sets:

AmazonGlacierStorage

Download-VBRDeletedArchivedBackupFile -BackupFile <VBRDeletedArchivedBackupFile>

-AmazonS3GlacierRetrievalPolicy <VBRAmazonS3GlacierRetrievalPolicy> [-Overwrite] [-RunAsync] [<CommonParameters>]
AzureArchiveStorage

Download-VBRDeletedArchivedBackupFile -BackupFile <VBRDeletedArchivedBackupFile>

-AzureArchiveRetrievalPolicy <VBRAzureArchiveRetrievalPolicy> [-Overwrite] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet retrieves a backup file deleted from the archive tier preserved by insider protection and uploads them to the performance tier.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
AmazonS3GlacierRetrievalPolicy	Defines the method of data retrieval for Amazon S3 Glacier object storage. You can retrieve data using one of the following method: `Expedited`: Use this method to retrieve archived data within 1–5 minutes. Note: this is the most expensive method. `Standard`: Use this method to retrieve archived data within 3–5 hours. `Bulk`: Use this method to retrieve archived data within 5–12 hours.	`VBRAmazonS3GlacierRetrievalPolicy`	True	Named	False
AzureArchiveRetrievalPolicy	Defines the method of data retrieval for Azure Archive storage. You can retrieve data using one of the following method: `StandardPriority`: Use this method to retrieve archived data within 15 hours. `HighPriority`: Use this method to retrieve archived data within an hour. Note: this is the most expensive method.	`VBRAzureArchiveRetrievalPolicy`	True	Named	False
BackupFile	Specifies an array of deleted backup files that you want to retrieve. Accepts the `VBRDeletedArchivedBackupFile[]` object. To get this object, run the `Get-VBRDeletedArchivedBackupFile` cmdlet.	`VBRDeletedArchivedBackupFile`	True	Named	True (ByPropertyName, ByValue)
Overwrite	Defines that the cmdlet will overwrite an existing object with the downloaded one.	`SwitchParameter`	False	Named	False
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Download-VBRDeletedArchivedBackupFile Example 1. Retrieving Backup Files from Amazon S3 Glacier

This example shows how to retrieve backup files from Amazon S3 Glacier.

$backupfile = Get-VBRDeletedArchivedBackupFile

Download-VBRDeletedArchivedBackupFile -BackupFile $backupfile[0] -AmazonS3GlacierRetrievalPolicy Standard -Overwrite

Perform the following steps:

Run the Get-VBRDeletedArchivedBackupFile cmdlet. Save the result to the $backupfile variable.
The Get-VBRDeletedArchivedBackupFile cmdlet will return an array of deleted backup files. Mind the ordinal number of the necessary backup file (in our example, it is the first backup file in the array).
Run the Download-VBRDeletedArchivedBackupFile cmdlet. Set the $backupfile[0] variable as the BackupFile parameter value. Specify the AmazonS3GlacierRetrievalPolicy parameter value. Provide the Overwrite parameter.

Download-VBRDeletedArchivedBackupFile Example 2. Retrieving Backup Files from Microsoft Azure Archive Storage

This example shows how to retrieve backup files from Microsoft Azure Archive Storage.

$backupfile = Get-VBRDeletedArchivedBackupFile

Download-VBRDeletedArchivedBackupFile -BackupFile $backupfile[0] -AzureArchiveRetrievalPolicy StandardPriority -Overwrite

Perform the following steps:

Run the Get-VBRDeletedArchivedBackupFile cmdlet. Save the result to the $backupfile variable.
The Get-VBRDeletedArchivedBackupFile cmdlet will return an array of deleted backup files. Mind the ordinal number of the necessary backup file (in our example, it is the first backup file in the array).
Run the Download-VBRDeletedArchivedBackupFile cmdlet. Set the $backupfile[0] variable as the BackupFile parameter value. Specify the AzureArchiveRetrievalPolicy parameter value. Provide the Overwrite parameter.