---
title: "Set-VBRNASBackupSecondaryTarget (obsolete)"
description: "This cmdlet modifies settings of secondary backup repositories. 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-vbrnasbackupsecondarytarget.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Obsolete Cmdlets > Set-VBRNASBackupSecondaryTarget (obsolete)"
dateModified: "2026-08-19"
---

# Set-VBRNASBackupSecondaryTarget

## Short Description
Modifies settings of secondary backup repositories.

::: note

This cmdlet is obsolete. Run the [`Set-VBRUnstructuredBackupSecondaryTarget`](set-vbrunstructuredbackupsecondarytarget.md) cmdlet instead.

:::

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

## Syntax
```
Set-VBRNASBackupSecondaryTarget -SecondaryTarget <VBRNASBackupSecondaryTarget>
 [-BackupRepository <CBackupRepository>] [-EnableCustomRetention]
 [-CustomRetentionType <VBRNASBackupShortTermRetentionType>] [-CustomRetentionPeriod <Int32>]
 [-UseCustomEncryptionKey] [-CustomEncryptionKey <VBREncryptionKey>] [-EnableBackupWindow]
 [-BackupWindow <VBRBackupWindowOptions>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of secondary backup repositories.

::: 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">BackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the backup repository that you want to add as a secondary backup repository to a file backup job.</p><p>Accepts the <code>CBackupRepository</code> object. To create this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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">BackupWindow</span></p>
        </td>
        <td>
          <p>Specifies backup window settings. Veeam Backup & Replication will create copies of backups that were created by file backup jobs according to these settings.</p><p>Accepts the <a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a> object. To create this object, run the <a href="new-vbrbackupwindowoptions.md"><code>New-VBRBackupWindowOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a></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">CustomEncryptionKey</span></p>
        </td>
        <td>
          <p>Specifies an encryption key. Veeam Backup & Replication will use this key to encrypt data that is stored on the secondary repository.</p><p><strong>Note</strong>: If you do not specify this parameter, Veeam Backup & Replication will apply an encryption key that is set to the file backup job to the secondary repository.</p><p>Accepts the <code>VBREncryptionKey</code> object. To create this object, run the <a href="get-vbrencryptionkey.md"><code>Get-VBREncryptionKey</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBREncryptionKey</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">CustomRetentionPeriod</span></p>
        </td>
        <td>
          <p>For the <code>ShortTermRetentionType</code> option.</p><p>Specifies the period of time to keep data on the secondary repository. When this period is passed, Veeam Backup & Replication will move data to the long-term repository.</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">CustomRetentionType</span></p>
        </td>
        <td>
          <p>Specifies a retention policy for the secondary repository. You can set retention policy to either of the following periods:</p><ul><li><code>Daily:</code> use this option if you want Veeam Backup & Replication to apply retention policy daily.</li><li><code>Monthly:</code> use this option if you want Veeam Backup & Replication to apply retention policy monthly.</li></ul><p>Use the <code>ShortTermRetentionPeriod</code> to specify the number of days or months.</p><p><strong>Note</strong>: If you do not specify this parameter, Veeam Backup & Replication will apply the retention policy of the file backup job to the secondary repository.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackupShortTermRetentionType</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">EnableBackupWindow</span></p>
        </td>
        <td>
          <p>Enables the backup window option.</p><p>If you provide this parameter, Veeam Backup & Replication will create copies of backups that were created by file backup jobs according to these settings.</p><p>Otherwise, Veeam Backup & Replication will copy data to the repository continuously.</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">EnableCustomRetention</span></p>
        </td>
        <td>
          <p>Enables the custom retention policy.</p><p>If you provide this parameter, Veeam Backup & Replication will apply this policy for backups located on the secondary backup repository. Otherwise, Veeam Backup & Replication will apply the retention policy of the file backup job to the secondary repository.</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">SecondaryTarget</span></p>
        </td>
        <td>
          <p>Specifies the secondary backup repository. The cmdlet will modify this repository.</p><p>Accepts the <code>VBRNASBackupSecondaryTarget</code> object. To create this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnasbackupsecondarytarget.md"><code>VBRNASBackupSecondaryTarget</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UseCustomEncryptionKey</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the custom encryption key option.</p><p>If you provide this parameter, Veeam Backup & Replication will use the encryption key to encrypt data that is stored on the secondary repository.</p><p>Otherwise, Veeam Backup & Replication will apply an encryption key that is set to the file backup job to the secondary repository.</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>
    </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
[`VBRNASBackupSecondaryTarget`](vbrnasbackupsecondarytarget.md)

## Examples

::: example
### Example 1. Enabling Custom Retention Policy

This example shows how to enable custom retention policy for the `SecondaryBackupRepository08` secondary backup repository. The custom retention policy will be enabled with the following settings:

- Veeam Backup & Replication will apply retention policy daily
- Veeam Backup & Replication will keep data on the secondary repository for 7 days

```
$repository = Get-VBRBackupRepository -Name "SecondaryBackupRepository08"
Set-VBRNASBackupSecondaryTarget -SecondaryTarget $repository -EnableCustomRetention -CustomRetentionType Daily -CustomRetentionPeriod 7
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Set-VBRNASBackupSecondaryTarget` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `SecondaryTarget` parameter value.
   - Provide the `EnableCustomRetention` parameter.
   - Set the `Daily` option as the `CustomRetentionType` parameter value.
   - Specify the `CustomRetentionPeriod` parameter value.

:::

::: example
### Example 2. Enabling Custom Encryption Key

This example shows how to enable custom encryption key for the `SecondaryBackupRepository08` secondary backup repository.

```
$repository = Get-VBRBackupRepository -Name "SecondaryBackupRepository08"
$key = Get-VBREncryptionKey -Description NasEncryption
Set-VBRNASBackupSecondaryTarget -SecondaryTarget $repository -UseCustomEncryptionKey -CustomEncryptionKey $key
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the [`Get-VBREncryptionKey`](get-vbrencryptionkey.md) cmdlet. Specify the `Description` parameter value.
3. Run the `Set-VBRNASBackupSecondaryTarget` cmdlet. Specify the following settings:

   - Set the `$repository` as the `SecondaryTarget` parameter value.
   - Provide the `UseCustomEncryptionKey` parameter.
   - Set the `$key` variable as the `CustomEncryptionKey` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBREncryptionKey`](get-vbrencryptionkey.md)