Set-VBRUnstructuredBackupArchivalOptions

Short Description

Modifies a scope of file versions to keep on an archive repository for file backup job or object storage backup job.

Note

This cmdlet is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Applies to

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

Syntax

Set-VBRUnstructuredBackupArchivalOptions -Options <VBRUnstructuredBackupArchivalOptions> [-ArchivalType <VBRUnstructuredBackupArchivalType> {All | InclusionMask | ExclusionMask}] [-InclusionMask <string[]>] [-ExclusionMask <string[]>] [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of a scope of file versions to keep on an archive repository for file backup job or object storage backup job.

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

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Options	Specifies the scope of file versions. The cmdlet will modify this scope.	VBRUnstructuredBackupArchivalOptions	True	Named	True (ByValue, ByPropertyName)
ArchivalType	Specifies the filter settings for file versions that you want to keep on the archive repository. You can specify one of the following filter settings: All: use this option if you want to keep all types of file versions on the archive repository. InclusionMask: use this option if you want to keep only file versions with specific extensions on the archive repository. Use the InclusionMask parameter to specify these extensions. ExclusionMask: use this option if you do not want to keep file versions with specific extensions on the archive repository. Use the ExclusionMask parameter to specify these extensions.	VBRUnstructuredBackupArchivalType	False	Named	False
InclusionMask	For the ArchivalType parameter with the InclusionMask value. Specifies a file mask for files and folders that you want to add to the file backup job or object storage backup job. The cmdlet will back up only these files and folders.	String[]	False	Named	False
ExclusionMask	For the ArchivalType parameter with the ExclusionMask value. Specifies a file mask for files and folders that you do not want to add to the file backup job or object storage backup job.	String[]	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRUnstructuredBackupArchivalOptions object that contains scope settings of files to keep on an archive repository for file backup job or object storage backup job.

Example

Modifying Scope of File Versions

This example shows how to modify a scope of file versions that are located on an archive repository. The archive repository will have the following file version settings:

The long-term repository will keep .DOCX and .PDF file extensions.
The long-term repository will not keep .EXE and .JPEG file extensions.

$archiveoptions = New-VBRUnstructuredBackupArchivalOptions -ArchivalType ExclusionMask -ExclusionMask ('*.jpeg', '*.exe')

Set-VBRUnstructuredBackupArchivalOptions -Options $archiveoptions -ArchivalType InclusionMask -InclusionMask ('*.docx', '*.pdf')

Perform the following steps:

Run the New-VBRUnstructuredBackupArchivalOptions cmdlet. Specify the ArchivalType and ExclusionMask parameters values. Save the result to the $archiveoptions variable.
Run the Set-VBRUnstructuredBackupArchivalOptions cmdlet. Specify the following settings:

Set the $archiveoptions variable as the Options parameter value.
Set the InclusionMask as the ArchivalType parameter value.
Specify the InclusionMask parameter value.

Related Commands

New-VBRUnstructuredBackupArchivalOptions