Publish-VBRArchiveRestorePoint

Short Description

Retrieves data from archive storage.

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

AmazonGlacierStorage

Publish-VBRArchiveRestorePoint -RestorePoint <COib> -AvailabilityPeriodDays <UInt32>

-AmazonS3GlacierRetrievalPolicy <VBRAmazonS3GlacierRetrievalPolicy> [-EnableExpirationNotification]

[-ExpirationHoursThreshold <Int32>] [-RunAsync] [<CommonParameters>]

AzureArchiveStorage

Publish-VBRArchiveRestorePoint -RestorePoint <COib> -AvailabilityPeriodDays <UInt32>

-AzureArchiveRetrievalPolicy <VBRAzureArchiveRetrievalPolicy> [-EnableExpirationNotification]

[-ExpirationHoursThreshold <Int32>] [-RunAsync] [<CommonParameters>]

S3GlacierCompatible

Publish-VBRArchiveRestorePoint -RestorePoint <COib> -AvailabilityPeriodDays <UInt32>

-S3GlacierCompatibleRetrievalPolicy <VBRS3GlacierCompatibleRetrievalPolicy> [-EnableExpirationNotification]

[-ExpirationHoursThreshold <Int32>] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet retrieves the backup files from the archive storage to the capacity extent of the scale-out backup repository. This is necessary for restore from archived backups.

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 methods: `Expedited` `Standard` `Bulk`	`VBRAmazonS3GlacierRetrievalPolicy`	True	Named	False
AvailabilityPeriodDays	Specifies a period (in days) during which the retrieved archive backup files will be available.	`UInt32`	True	Named	False
AzureArchiveRetrievalPolicy	Defines the method of data retrieval for Azure Archive storage. You can retrieve data using one of the following methods: `StandardPriority` `HighPriority`	`VBRAzureArchiveRetrievalPolicy`	True	Named	False
EnableExpirationNotification	Enables sending of notification about upcoming expiration of the retrieved archive backup files availability. Default: `False`.	`SwitchParameter`	False	Named	False
ExpirationHoursThreshold	For the `EnableExpirationNotification` parameter. Specifies the moment when the user receives the notification about upcoming expiration of the retrieved archive backup files availability.	`Int32`	False	Named	False
RestorePoint	Specifies the restore point for which you want to execute publish. Accepts the `COib` object. To get this object, run the `Get-VBRRestorePoint` cmdlet.	`COib`	True	Named	False
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	False
S3GlacierCompatibleRetrievalPolicy	Defines the method of data retrieval for S3 compatible object storage with with data archiving. You can retrieve data using one of the following methods: `Expedited` `Standard` `Bulk`	`VBRS3GlacierCompatibleRetrievalPolicy`	True	Named	False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRPublishedBackupSession object.

Examples

Publish-VBRArchiveRestorePoint Example 1. Retrieving Backup Files from Amazon S3 Glacier Archive Extent

This example shows how to retrieve backup files from the Amazon S3 Glacier archive extent of the scale-out backup repository.

$backup = Get-VBRBackup -Name "JOB_2"

$rp = Get-VBRRestorePoint -Backup $backup

Publish-VBRArchiveRestorePoint -RestorePoint $rp[0] -AvailabilityPeriodDays 3 -AmazonS3GlacierRetrievalPolicy Standard

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRRestorePoint cmdlet. Set the $backup variable as the Backup parameter value. Save the result to the $rp variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the first restore point in the array).
Run the Publish-VBRArchiveRestorePoint cmdlet. Specify the following settings:
- Set the $rp variable as the RestorePoint parameter value.
- Specify the AvailabilityPeriodDays parameter value.
- Set the Standard option for the AmazonS3GlacierRetrievalPolicy parameter.

Publish-VBRArchiveRestorePoint Example 2. Retrieving Data from Amazon S3 Glacier Archive Storage for Multiple Restore Points

This example shows how to retrieve several restore points from the Amazon S3 Glacier archive storage with the following settings:

Data retrieval will take from 3–5 hours.
The retrieved archive backup files will be available for 5 days.

Get-VBRRestorePoint

$RPIds = @('fdea6323-e018-44ef-abf3-346e0453134b', 'c57cc164-773f-494a-8fb5-aa960cba0f2d', '3898ab90-4419-4bea-b1a2-b13b93170ad3' )

foreach ($restorePointId in $RPIds)

{

$restorepoint = Get-VBRRestorePoint -Id $restorePointId

Publish-VBRArchiveRestorePoint -RestorePoint $restorepoint -AvailabilityPeriodDays 5 -AmazonS3GlacierRetrievalPolicy Standard -RunAsync

}

Perform the following steps:

Get a list of all restore points. Run the Get-VBRRestorePoint cmdlet. The cmdlet will return an array of restore points of tenant backups located in the archive tier. Select the necessary restore points from an array of restore points.
Define an array of restore points. Specify the necessary restore point IDs. Save the result to the $RPIds variable.
Run the Get-VBRCloudTenant cmdlet. Specify the Name parameter value. Save the result to the $tenant variable.
Run the foreach statement.
1. Set the $restorePointId as a variable and the $RPIds as a collection. With each iteration, the foreach statement will set the $restorePointId variable to the next value in the $RPIds collection.
2. Specify the Get-VBRRestorePoint and Publish-VBRArchiveRestorePoint cmdlets. With each iteration, the foreach statement will execute these cmdlets.