Set-VBRSimpleRetentionPolicy

Short Description

Modifies 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

Set-VBRSimpleRetentionPolicy -RetentionPolicy <VBRSimpleRetentionPolicy> [-RestorePoints <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet modifies a retention policy for backup copy jobs that process backups stored on external repositories.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
RestorePoints	Specifies a number of restore points.	`Int32`	False	Named	False
RetentionPolicy	Specifies a retention policy for a backup copy job. The cmdlet will modify this policy. Accepts the `VBRSimpleRetentionPolicy` object. To get this object, run the `Get-VBRRetentionPolicy` cmdlet.	`VBRSimpleRetentionPolicy`	True	Named	True (ByValue)

<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

Modifying Retention Policy for Backup Copy Job

This example shows how to modify a retention policy for a backup copy job. The target backup repository will keep the last 5 restore points.

$job = Get-VBRJob -Name "EC2 BCJ 01"

$policy = Get-VBRRetentionPolicy -Job $job

Set-VBRSimpleRetentionPolicy -RetentionPolicy $policy -RestorePoints 5

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBRRetentionPolicy cmdlet. Set the $job variable as the Job parameter value. Save the result to the $policy variable.
Run the Set-VBRSimpleRetentionPolicy cmdlet. Set the $policy variable as the RetentionPolicy parameter value. Specify the RestorePoints parameter value.