New-VBRNASBackupVersionRetentionOptions (obsolete)
Short Description
Defines version-based retention policy settings that will be applied for the file backup job.
|
Note |
|
This cmdlet is obsolete. Run the New-VBRUnstructuredBackupVersionRetentionOptions cmdlet instead. |
Applies to
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
|
New-VBRNASBackupVersionRetentionOptions [-VersionRetentionType {None | Archive | BackupAndArchive}] [-ActiveFileVersionRetention <int>] [-DeletedFileVersionRetention <int>] [<CommonParameters>] |
Detailed Description
This cmdlet defines version-based retention policy settings that will be applied for the file backup job.
For file backups, Veeam Backup & Replication allows specifying not only for how long to keep copies of all recent file versions, but also how many file versions to keep in the backup repository.
|
Important |
|
If you use retention options configured with the New-VBRNASBackupArchivalOptions cmdlet, the settings configured with New-VBRNASBackupVersionRetentionOptions scripts may not work correctly. |
Parameters
|
Parameter |
Description |
Type |
Required |
Position |
Accept Pipeline Input |
|---|---|---|---|---|---|
|
VersionRetentionType |
Specifies to what repositories the version-based retention policy will be applied. You can specify one of the following filter settings:
Note: If you do not specify this parameter, version-based retention policy settings are applied by default both to backup and archive repositories. |
VBRNASBackupVersionRetentionType |
False |
Named |
False |
|
ActiveFileVersionRetention |
Specifies the number of active file versions. Veeam Backup & Replication will keep the specified number of file versions for active (not deleted) files. Once the number of file versions exceeds, Veeam Backup & Replication will remove the oldest file version from the repository. Note: If you do not specify this parameter, the number of file versions for active files is set to unlimited. Veeam Backup & Replication will delete file versions for active files from the backup repository after the specified retention period passes. Default: 10. |
Int32 |
False |
Named |
False |
|
DeletedFileVersionRetention |
Specifies the number of file versions for deleted files. Veeam Backup & Replication will keep the specified number of file versions for deleted files. Once the number of file versions exceeds, Veeam Backup & Replication will remove the oldest version from the repository. Note: If you do not specify this parameter, the number of file versions for deleted files is set to unlimited. Veeam Backup & Replication will remove files versions for deleted files from the backup repository after the specified retention period passes. Default: 3. |
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 VBRNASBackupVersionRetentionOptions object that contains version-based retention settings that will be added to the file backup job.
Examples
Example 1. Defining Retention Policy for File Versions of Active Files Both in Backup and Archive Repositories
|
This command shows how to define retention policy for file versions of active files. The backup and archive repositories together will keep file versions of active files for 14 days.
|
Example 2. Defining Retention Policy for File Versions of Deleted Files in Archive Repository
|
This command shows how to define retention policy for file versions of deleted files. The version-based retention settings applies to the archive repository only and it will keep file versions of deleted files for 7 days.
|