---
title: "New-VBRNASBackupSecondaryTarget (obsolete)"
description: "This cmdlet creates secondary backup repositories. These repositories will keep copies of backup files that were created by file backup jobs."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrnasbackupsecondarytarget.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Obsolete Cmdlets > New-VBRNASBackupSecondaryTarget (obsolete)"
dateModified: "2026-08-19"
---

# New-VBRNASBackupSecondaryTarget

## Short Description
Creates secondary backup repositories for file backup jobs.

::: note

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

:::

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

## Syntax
```
New-VBRNASBackupSecondaryTarget -BackupRepository <CBackupRepository>
 [-CustomRetentionType <VBRNASBackupShortTermRetentionType>] [-CustomRetentionPeriod <Int32>]
 [-CustomEncryptionKey <VBREncryptionKey>] [-BackupWindow <VBRBackupWindowOptions>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates secondary backup repositories. These repositories will keep copies of backup files that were created by file backup jobs.

## 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>True</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>
    </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. Creating Backup Repository

This example shows how to create a secondary backup repository. The secondary repository will be created with the following settings:

- Veeam Backup & Replication will apply a retention policy that is set to the file backup job.
- Veeam Backup & Replication will apply an encryption key that is set to the file backup job.
- Veeam Backup & Replication will copy data to the repository continuously.

```
$repository = Get-VBRBackupRepository -Name "Backup Repository 07"
New-VBRNASBackupSecondaryTarget -BackupRepository $repository
```

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 `New-VBRNASBackupSecondaryTarget` cmdlet. Set the `$repository` variable as the `BackupRepository` parameter value.

:::

::: example
### Example 2. Creating Backup Repository with Custom Retention Policy

This example shows how to create a secondary backup repository with the custom retention policy. Veeam Backup & Replication will keep versions of backup files on the secondary backup repository for 7 days.

```
$repository = Get-VBRBackupRepository -Name "Backup Repository 07"
New-VBRNASBackupSecondaryTarget -BackupRepository $repository -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 `New-VBRNASBackupSecondaryTarget` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `BackupRepository` parameter value.
   - Set the `Daily` option for the `CustomRetentionType` parameter.
   - Specify the `CustomRetentionPeriod` parameter value.

:::

::: example
### Example 3. Creating Backup Repository with Backup Window

This example shows how to create a secondary backup repository. Veeam Backup & Replication will copy data to the secondary repository according to the following schedule:

- From 22:00 to 22:59 on Friday
- From 22:00 to 22:59 on Saturday

```
$repository = Get-VBRBackupRepository -Name "Backup Repository 07"
$windowoptions = New-VBRBackupWindowOptions -FromDay Friday -FromHour 22 -ToDay Saturday -ToHour 22 -Enabled
New-VBRNASBackupSecondaryTarget -BackupRepository $repository -BackupWindow $windowoptions
```

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 [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the necessary parameters. Save the result to the `$windowoptions` variable.
3. Run the `New-VBRNASBackupSecondaryTarget` cmdlet. Set the `$repository` variable as the `BackupRepository` parameter value. Set the `$windowoptions` variable as the `BackupWindow` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)