---
title: "Set-VBRBackupCacheOptions"
description: "This cmdlet modifies backup cache settings that you can apply to Veeam Agent backup jobs. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrbackupcacheoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Advanced Settings > Set-VBRBackupCacheOptions"
dateModified: "2026-08-19"
---

# Set-VBRBackupCacheOptions

## Short Description
Modifies backup cache settings for Veeam Agent backup jobs.

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

## Syntax
```
Set-VBRBackupCacheOptions -Options <VBRBackupCacheOptions> [-Enable] [-Type <VBRBackupCacheSelectionType>]
 [-LocalPath <String>] [-SizeLimit <Int32>] [-SizeUnit <VBRBackupCacheSizeUnit>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies backup cache settings that you can apply to Veeam Agent backup jobs.

::: 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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Enable</span></p>
        </td>
        <td>
          <p>Defines that the backup cache option is enabled.</p><p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LocalPath</span></p>
        </td>
        <td>
          <p>For the <code>Manual</code> option of the <code>Type</code> parameter.</p><p>Specifies a path to the folder on a protected computer. The cmdlet will keep the cached data in the specified folder.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Options</span></p>
        </td>
        <td>
          <p>Specifies backup cache settings that you want to modify.</p><p>Accepts the <code>VBRBackupCacheOptions</code> object. To create this object, run the <a href="new-vbrbackupcacheoptions.md"><code>New-VBRBackupCacheOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRBackupCacheOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SizeLimit</span></p>
        </td>
        <td>
          <p>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.</p><p>Provide the <code>SizeUnit</code> parameter to specify the unit of measure.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SizeUnit</span></p>
        </td>
        <td>
          <p>For the <code>SizeLimit</code> option.</p><p>Specifies the unit of measure to keep backup cache files. You can specify either of the following units:</p><ul><li><code>GB</code></li><li><code>TB</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRBackupCacheSizeUnit</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Type</span></p>
        </td>
        <td>
          <p>Specifies how to choose the location to keep cached data. You can specify one of the following options:</p><ul><li><code>Automatic</code>: use this option if you want Veeam Backup & Replication to define the cached data location automatically on every computer.</li><li><code>Manual</code>: use this option if you want explicitly define the location to keep cached data on every computer. Provide the <code>LocalPath</code> parameter to specify a path to the folder where the cached data must be stored.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRBackupCacheSelectionType</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
This cmdlet returns the `VBRBackupCacheOptions` object that contains backup cache settings.

## Examples

::: example
### Example 1. Modifying Location Option

This example shows how to modify the location settings to keep cached data. The cmdlet will change the manual selection of location to the automatic selection.

```
$options = New-VBRBackupCacheOptions -Enable -Type Manual -LocalPath "C:\Backup" -SizeLimit 10 -SizeUnit TB
Set-VBRBackupCacheOptions -Options $options -Type Automatic
```

Perform the following steps:

1. Run the [`New-VBRBackupCacheOptions`](new-vbrbackupcacheoptions.md) cmdlet. Provide the `Enable` parameter. Specify the `Type`, `LocalPath`, `SizeLimit` and `SizeUnit` parameter values. Save the result to the `$options` variable.
2. Run the `Set-VBRBackupCacheOptions` cmdlet. Set the `$options` variable as the `Options` parameter value. Set the `Automatic` option for the `Type` parameter.

:::

::: example
### Example 2. Modifying Size Limit of Backup Cache

This example shows how to modify size limits for backup cache. The cmdlet will change size limits from 10 TB to 15 TB.

```
$options = New-VBRBackupCacheOptions -Enable -Type Manual -LocalPath "C:\Backup" -SizeLimit 10 -SizeUnit TB
Set-VBRBackupCacheOptions -Options $options -SizeLimit 15
```

Perform the following steps:

1. Run the [`New-VBRBackupCacheOptions`](new-vbrbackupcacheoptions.md) cmdlet. Provide the `Enable` parameter. Specify the `Type`, `LocalPath`, `SizeLimit` and `SizeUnit` parameter values. Save the result to the `$options` variable.
2. Run the `Set-VBRBackupCacheOptions` cmdlet. Set the `$options` variable as the `Options` parameter value. Specify the `SizeLimit` parameter value.

:::

## Related Commands

[`New-VBRBackupCacheOptions`](new-vbrbackupcacheoptions.md)