New-VBRSimpleRetentionPolicy

Short Description

Creates a retention policy for backup copy jobs that process backups stored on external repositories.

Platform: VMware, Hyper-V

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

Syntax

New-VBRSimpleRetentionPolicy [-RestorePoints <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet specifies a retention policy for backup copy job that process backups stored on external repositories. Veeam Backup & Replication will keep regular backups on the target backup repository according to this policy.

Note

Run the New-VBRGFSRetentionPolicyCreates a GFS retention policy for backup copy jobs that process backups stored on external repositories. cmdlet to create the GFS retention policy for backup copy jobs.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoints

Specifies a number of restore points. Veeam Backup & Replication will keep the selected number of restore points on the target backup repository.

Int32

False

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 VBRSimpleRetentionPolicy object that contains a retention policy for backup copy jobs that process backups stored on external repositories.

Examples

Creating Retention Policy for Backup Copy Job

This command creates a retention policy for a backup copy job. The target backup repository will keep the last 5 restore points.

New-VBRSimpleRetentionPolicy -RestorePoints 5

Page updated 2026-08-19

Page content applies to build 13.1.1.18