Set-VBRImmutabilityLockExpirationDate

Short Description

Modifies immutability period of restore points located in a hardened repository.

Important

This cmdlet does not support the following types of restore points:

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Extend immutability period of restore points located in a hardened repository.

Set-VBRImmutabilityLockExpirationDate -RestorePoint <COib[]> -ExpirationDate <datetime>  [<CommonParameters>]

  • Reset immutability period of restore points located in a hardened repository.

Set-VBRImmutabilityLockExpirationDate -RestorePoint <COib[]> -ToOriginal  [<CommonParameters>]

Detailed Description

This cmdlet modifies immutability period of restore points located in a hardened repository.

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.

Important

It is not possible to reduce immutability via PowerShell commands. After you set the value, you can either extend it or reset back to the original value. However, you cannot set it to a smaller value than was originally set.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoint

Specifies an array of restore points. The cmdlet will modify immutability period for these restore points.

Accepts the COib[] object. To create this object, run the Get-VBRRestorePoint cmdlet.

True

0

True (ByValue, ByPropertyName)

ExpirationDate

Specifies a date when Veeam Backup & Replication is allowed to remove restore points from a hardened repository with immutability.

DateTime

True

Named

False

ToOriginal

Defines that the cmdlet will reset the immutability period of restore points to their original value. If you provide this value, the cmdlet will set the immutability to the maximum time period that is available for the hardened repository.

Default: False.

SwitchParameter

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 VBRImmutabilityLockExpirationDate object that contains immutability period of of restore points located in hardened repository with immutability.

Examples

Set-VBRImmutabilityLockExpirationDateExample 1. Extending Immutability Period of Restore Points

Set-VBRImmutabilityLockExpirationDateExample 2. Resetting Immutability Period of Restore Points

Related Commands

Page updated 1/6/2025

Page content applies to build 12.3.1.1139