Copy-VBRUnstructuredBackup

Short Description

Copies backups created by file backup jobs and object storage backup jobs to another location.

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

Syntax

Copy-VBRUnstructuredBackup -Backup <VBRUnstructuredBackup[]> -BackupRepository <CBackupRepository>

[-ArchiveRepository <IRepository>] [-RunAsync]

[-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet copies backups created by file backup jobs and object storage backup jobs to one of the following locations:

Another repository
Local folder
Shared folder
Archive repository

Veeam Backup & Replication copies the whole backup chain. When Veeam Backup & Replication performs the copy operation, it disables the job, copies files to the target location and then enables the job.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
ArchiveRepository	Specifies the archive repository. The cmdlet will copy the backups created by file backup jobs and object storage backup jobs to this long-term archive repository. Accepts the `CBackupRepository` object. To get this object, run the following cmdlets: `Get-VBRBackupRepository`: use this cmdlet to get backup repositories. `Get-VBRObjectStorageRepository`: use this cmdlet to get object storage repositories.	`IRepository`	False	Named	False
Backup	Specifies an array of backups created by file backup jobs and object storage backup jobs. The cmdlet will copy these backups to a specified backup repository. Accepts the `VBRUnstructuredBackup[]` object. To get this object, run the `Get-VBRUnstructuredBackup` cmdlet.	`VBRUnstructuredBackup[]`	True	Named	True (ByValue)
BackupRepository	Specifies the backup repository. The cmdlet will copy the backups created by file backup jobs and object storage backup jobs to this backup repository. Accepts the `CBackupRepository` object. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository`	True	Named	False
Force	Defines that the cmdlet will copy unstructured data backups without showing warnings in the PowerShell console.	`SwitchParameter`	False	Named	False
RetrievalSettings	Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive object storage repositories. Note: If you do not provide this parameter, the cmdlet will prompt you to use the default retrieval policy settings. Accepts the `VBRUnstructuredBackupColdStorageRetrievalSettings` object. To create this object, run the `New-VBRUnstructuredBackupColdStorageRetrievalSettings` cmdlet.	`VBRUnstructuredBackupColdStorageRetrievalSettings`	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

Copying Object Storage Backups to Another Repository

This example shows how to copy object storage backups to another repository.

$backup = Get-VBRUnstructuredBackup

$repository = Get-VBRBackupRepository

Copy-VBRUnstructuredBackup -Backup $backup[3] -BackupRepository $repository

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Save the result to the $backup variable.
Run the Get-VBRBackupRepository cmdlet. Save the result to the $repository variable.
Run the Copy-VBRUnstructuredBackup cmdlet. Set the $backup[3] variable as the Backup parameter value. Set the $repository variable as the BackupRepository parameter value.