This is an archive version of the document. To get the most up-to-date information, see the current version.

Set-VBRBackupCacheOptions

Short Description

Modifies backup cache settings.

Applies to

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

Syntax

Set-VBRBackupCacheOptions -Options <VBRBackupCacheOptions> [-Enable] [-Type <VBRBackupCacheSelectionType> {Automatic | Manual}] [-LocalPath <string>] [-SizeLimit <int>] [-SizeUnit <VBRBackupCacheSizeUnit> {GB | TB}] [<CommonParameters>]

Detailed Description

This cmdlet modifies backup cache settings. To modify settings, you need to specify new values for the necessary parameters. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Options	Specifies backup cache settings that you want to modify.	Accepts the VBRBackupCacheOptions object. To create this object, run the New-VBRBackupCacheOptions cmdlet.	True	Named	True (ByValue)
Enable	Defines that the backup cache option is enabled. If you provide this parameter, backup files will remain in the cache of the protected computers until these computers are able to connect to Veeam Backup & Replication.	SwitchParameter	False	Named	False
Type	Specifies how to choose the location to keep cached data. You can specify one of the following options: Automatic: use this option if you want Veeam Backup & Replication to define the cached data location automatically on every computer. Manual: use this option if you want explicitly define the location to keep cached data on every computer. Provide the LocalPath parameter to specify a path to the folder where the cached data must be stored.	VBRBackupCacheSelectionType	False	Named	False
LocalPath	For the Manual option of the Type parameter. Specifies a path to the folder on a protected computer. The cmdlet will keep the cached data in the specified folder.	String	False	Named	False
SizeLimit	Specifies a size limit of a backup cache file in numbers. Veeam Backup & Replication will remove backup cache data from the folder when this limit is exceeded. Provide the SizeUnit parameter to specify the unit of measure.	Int32	False	Named	False
SizeUnit	For the SizeLimit option. Specifies the unit of measure to keep backup cache files. You can specify either of the following units: GB TB	VBRBackupCacheSizeUnit	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

This cmdlet returns the VBRBackupCacheOptions object that contains backup cache settings.

Examples

Set-VBRBackupCacheOptions Example 1. Modifying Location Option

Set-VBRBackupCacheOptions Example 2. Modifying Size Limit of Backup Cache

Related Commands

New-VBRBackupCacheOptions