---
title: "Add-VBRBackupRepository"
description: "Adds a backup repository to the backup infrastructure. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet adds a new backup reposito"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrbackuprepository.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Backup Repositories > Add-VBRBackupRepository"
dateModified: "2026-08-20"
---

# Add-VBRBackupRepository

## Short Description
Adds a backup repository to the backup infrastructure.

**Platform**: VMware, Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Add-VBRBackupRepository [-Name <String>] [-Description <String>] [-Server <CHost[]>] [-AutoSelectGateway]
 [-MountServer <CHost>] [-MountServerOptions <VBRRepositoryMountServerOptions[]>] -Folder <String>
 -Type <VBRRepositoryType> [-ImportIndex] [-ImportBackup] [-RotatedDrive]
 [-RotatedDriveCleanupMode <VBRRotatedDriveCleanupMode>] [-MountFolder <String>] [-EnableVPowerNFS]
 [-VPowerNFSPort <Int32>] [-MountPort <Int32>] [-DDServerName <String>] [-StoreOnceServerName <String>]
 [-StoreOnceWanLink] [-LimitConcurrentJobs] [-MaxConcurrentJobs <Int32>] [-LimitDatarate]
 [-DataRateLimit <Int32>] [-AlignDataBlocks] [-DecompressDataBlocks] [-UsePerVMFile]
 [-DDBoostEncryptionType <VBRDDBoostEncryptionType>] [-EnableXFSFastClone] [-EnableReFSFastClone]
 [-EnableBackupImmutability] [-ImmutabilityPeriod <Int32>] [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>AddCredentials</code></p>

```
Add-VBRBackupRepository [-Name <String>] [-Description <String>] [-Server <CHost[]>] [-AutoSelectGateway]
 [-MountServer <CHost>] [-MountServerOptions <VBRRepositoryMountServerOptions[]>] -Folder <String>
 -Type <VBRRepositoryType> [-ImportIndex] [-ImportBackup] [-RotatedDrive]
 [-RotatedDriveCleanupMode <VBRRotatedDriveCleanupMode>] [-MountFolder <String>] [-EnableVPowerNFS]
 [-VPowerNFSPort <Int32>] [-MountPort <Int32>] [-DDServerName <String>] [-StoreOnceServerName <String>]
 [-StoreOnceWanLink] [-UserName <String>] [-Password <String>] [-LimitConcurrentJobs]
 [-MaxConcurrentJobs <Int32>] [-LimitDatarate] [-DataRateLimit <Int32>] [-AlignDataBlocks]
 [-DecompressDataBlocks] [-UsePerVMFile] [-DDBoostEncryptionType <VBRDDBoostEncryptionType>]
 [-EnableXFSFastClone] [-EnableReFSFastClone] [-EnableBackupImmutability] [-ImmutabilityPeriod <Int32>]
 [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Credentials</code></p>

```
Add-VBRBackupRepository [-Name <String>] [-Description <String>] [-Server <CHost[]>] [-AutoSelectGateway]
 [-MountServer <CHost>] [-MountServerOptions <VBRRepositoryMountServerOptions[]>] -Folder <String>
 -Type <VBRRepositoryType> [-ImportIndex] [-ImportBackup] [-RotatedDrive]
 [-RotatedDriveCleanupMode <VBRRotatedDriveCleanupMode>] [-MountFolder <String>] [-EnableVPowerNFS]
 [-VPowerNFSPort <Int32>] [-MountPort <Int32>] [-DDServerName <String>] [-StoreOnceServerName <String>]
 [-StoreOnceWanLink] [-Credentials <CCredentials>] [-LimitConcurrentJobs] [-MaxConcurrentJobs <Int32>]
 [-LimitDatarate] [-DataRateLimit <Int32>] [-AlignDataBlocks] [-DecompressDataBlocks] [-UsePerVMFile]
 [-DDBoostEncryptionType <VBRDDBoostEncryptionType>] [-EnableXFSFastClone] [-EnableReFSFastClone]
 [-EnableBackupImmutability] [-ImmutabilityPeriod <Int32>] [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet adds a new backup repository to the backup infrastructure.

To add a scale-out backup repository, run the [`Add-VBRScaleOutBackupRepository`](add-vbrscaleoutbackuprepository.md) cmdlet.

## 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">AlignDataBlocks</span></p>
        </td>
        <td>
          <p>Defines that the backup blocks size will be aligned by a 4Kb block boundary. Data alignment provides better deduplication on storage systems with fixed block size.</p><p>Default: <code>False</code>.</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">AutoSelectGateway</span></p>
        </td>
        <td>
          <p>Enables automatic selection of gateway servers.</p><p>Default: <code>False</code>.</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">Credentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials you want to use for authenticating with the backup repository host.</p><p>Accepts the <code>CCredentials</code> object. To get this object, run the <a href="get-vbrcredentials.md"><code>Get-VBRCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">DataRateLimit</span></p>
        </td>
        <td>
          <p>Used for setting combined data ingestion rate for the <code>LimitDatarate</code> parameter.</p><p>Specifies the combined data ingestion rate for the repository.</p><p>Permitted value: <code>1</code> to <code>1024</code> (MByte/s).</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">DDBoostEncryptionType</span></p>
        </td>
        <td>
          <p>Specifies the native Dell Data Domain encryption level:</p><ul><li><code>High</code></li><li><code>Medium</code></li><li><code>None</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRDDBoostEncryptionType</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">DDServerName</span></p>
        </td>
        <td>
          <p>Specifies the Data Domain server name. Enter the name in the following formats depending on the connection mode:</p><ul><li>If Dell Data Domain works over TCP/IP, enter a full DNS name or an IP address of the Dell Data Domain server.</li><li>If Dell Data Domain works over Fibre Channel, enter a name of the Data Domain server starting with the <code>DFC-</code> prefix, for example, DFC-DataDomain690.</li></ul>
        </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">DecompressDataBlocks</span></p>
        </td>
        <td>
          <p>Defines that the backup data blocks must be decompressed before storing to the repository.</p><p>Default: <code>False</code>.</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the backup repository.</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">EnableBackupImmutability</span></p>
        </td>
        <td>
          <p>Enables the immutability option for a backup repository.</p><p>Default: <code>False</code>.</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">EnableReFSFastClone</span></p>
        </td>
        <td>
          <p>Enables the ReFS Fast Clone technology for SMB backup repositories.</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">EnableVPowerNFS</span></p>
        </td>
        <td>
          <p>Enables the repository to be accessible by the vPower NFS service. Default: False.</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">EnableXFSFastClone</span></p>
        </td>
        <td>
          <p>Enables the Fast Clone technology for the backup repository.</p><p>Default: <code>False</code>.</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">Folder</span></p>
        </td>
        <td>
          <p>Specifies the full path to the folder where you want to store the backups.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a backup repository without showing warnings in the PowerShell console.</p><p>Default: <code>False</code>.</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">ImmutabilityPeriod</span></p>
        </td>
        <td>
          <p>For the immutability option.</p><p>Defines a number of days within which Veeam Backup & Replication will not delete blocks of data from the backup repository.</p><p>Default: 30 days.</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">ImportBackup</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will import backups that are currently located on the server you are adding as repository.</p><p>Default: <code>False</code>.</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">ImportIndex</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will import the guest OS file system index.</p><p>Default: <code>False</code>.</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">LimitConcurrentJobs</span></p>
        </td>
        <td>
          <p>Defines that the number of concurrent jobs using this repository must be limited.</p><p>Use the <code>MaxConcurrentJobs</code> parameter to set the maximum value.</p><p>Default: <code>True</code>.</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">LimitDatarate</span></p>
        </td>
        <td>
          <p>Defines that the total speed of writing data to the backup repository disk must be restricted.</p><p>Use the <code>DataRateLimit</code> parameter to set the maximum value.</p><p>Default: <code>False</code>.</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">MaxConcurrentJobs</span></p>
        </td>
        <td>
          <p>Used for setting maximum value for the <code>LimitConcurrentJobs</code> parameter.</p><p>Specifies the maximum allowed number of concurrent tasks for the backup repository.</p><p>Permitted values: <code>1</code> to <code>128</code>.</p><p>Permitted values for Dell Data Domain: <code>1</code> to <code>270</code>.</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">MountFolder</span></p>
        </td>
        <td>
          <p>Specifies the path to the mount folder. Veeam Backup & Replication will use this folder to mount VM disks and to keep write cache data.</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">MountPort</span></p>
        </td>
        <td>
          <p>Specifies the port number of the mount server.</p><p>Default: <code>1058</code>.</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">MountServer</span></p>
        </td>
        <td>
          <p>Specifies the mount server associated with the backup repository. You can assign the mount server role to the backup repository itself or to a server that resides close to the backup repository.</p><p>Accepts the <code>CHost</code> object. To create this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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">MountServerOptions</span></p>
        </td>
        <td>
          <p>Specifies the mount server settings for the servers that you plan to use as mount servers during the restore process.</p><p>Accepts the <code>VBRRepositoryMountServerOptions[]</code> object. To create this object, run the <a href="new-vbrrepositorymountserveroptions.md"><code>New-VBRRepositoryMountServerOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrepositorymountserveroptions.md"><code>VBRRepositoryMountServerOptions[]</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies the name you want to assign to the new backup repository.</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">NFSRepositoryEncoding</span></p>
        </td>
        <td>
          <p>Specifies encoding for NFS share. You can specify either of the following values:</p><ul><li><code>utf</code></li><li><code>ansi</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASEncoding</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">Password</span></p>
        </td>
        <td>
          <p>Specifies the password you want to use for authenticating with the backup repository host.</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">RotatedDrive</span></p>
        </td>
        <td>
          <p>Defines that the repository you want to add is a rotated drive (removable media).</p><p>Default: <code>False</code>.</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">RotatedDriveCleanupMode</span></p>
        </td>
        <td>
          <p>Defines how Veeam Backup & Replication behaves when a drive is swapped:</p><ul><li><code>ContinueBackupChain</code>: use this option to continue the backup chain.</li><li><code>ClearBackupFolder</code>: use this option to delete all backups created by a job.</li><li><code>ClearRepositoryFolder</code>: use this option to delete all backups stored in the repository folder (for example, <code>C:\Backups\</code>). Note that Veeam Backup & Replication will delete all backups, even backups created by other jobs.</li></ul><p>Default: <code>ContinueBackupChain</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRRotatedDriveCleanupMode</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">Server</span></p>
        </td>
        <td>
          <p>Specifies the host where the backup repository you want to add is located and host that will be used as gateway servers.</p><p>Use this parameter to explicitly set the host for the following repository types:</p><ul><li><p><code>WinLocal</code>: to specify a Windows based server where you want to create the backup repository or to which you want to connect the rotated drives.</p></li><li><p><code>LinuxLocal</code> type: to specify a Linux based server where you want to create the backup repository or to which you want to connect the rotated drives.</p><p><strong>Note</strong>: when you specify an array of hosts, the first host is used as a backup repository, the others are used as gateway servers.</p></li><li><p><code>CifsShare</code>, <code>DataDomain</code> or <code>HPStoreOnce</code>: to specify a Windows based server to which the storage appliance is connected and which will be used as a gateway server.</p></li></ul><p>Default: This server.</p><p>Accepts the <code>CHost[]</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost[]</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">StoreOnceServerName</span></p>
        </td>
        <td>
          <p>Specifies the HPE StoreOnce server name.</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">StoreOnceWanLink</span></p>
        </td>
        <td>
          <p>Defines that the HPE StoreOnce must use source-side deduplication.</p><p>Default: <code>False</code>.</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">Type</span></p>
        </td>
        <td>
          <p>Specifies the type you want to assign to the repository:</p><ul><li><code>WinLocal</code></li><li><code>LinuxLocal</code></li><li><code>CifsShare</code></li><li><code>ExaGrid</code></li><li><code>DataDomain</code></li><li><code>HPStoreOnceIntegration</code></li><li><code>Quantum</code></li><li><code>Nfs</code></li><li><code>Infinidat</code></li><li><code>Fujitsu</code></li><li><code>HPStoreOnceCloudBank</code></li><li><code>Hardened</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRRepositoryType</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">UsePerVMFile</span></p>
        </td>
        <td>
          <p>This parameter is obsolete and is not supported.</p><p><strong>Note</strong>: Backup repositories always create per-VM backup files.</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">UserName</span></p>
        </td>
        <td>
          <p>Specifies the user name you want to use for authenticating with the backup repository host.</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">VPowerNFSPort</span></p>
        </td>
        <td>
          <p>Specifies the port number of the vPower NFS Service. Veeam Backup & Replication will set up a direct connection between the backup repository and ESXi to which the vPower NFS datastore is mounted.</p><p>Default: <code>2049</code>.</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>
    </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
The cmdlet returns the `CBackupRepository` object that contains settings of backup repositories added to the backup infrastructure.

## Examples

::: example
### Example 1. Adding Windows Server as Backup Repository

This example shows how to add the `Win2012` Windows server as a new backup repository named `Win2012Repo`. The cmdlet will add the backup repository with the following settings:

- Veeam Backup & Replication does not authenticate against the `Win2012` Windows server.
- The folder that is used as the backup repository is located on `C:\Backup Repository`.
- The server type is set to `WinLocal`.

```
$server = Get-VBRServer -Name "Win2012"
Add-VBRBackupRepository -Name "Win2012Repo" -Server $server -Folder "c:\Backup Repository" -Type WinLocal
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Folder` parameter value.
   - Specify the `Type` parameter value.

:::

::: example
### Example 2. Adding Linux Server as Backup Repository

This example shows how to add a Linux server as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: `/home/Admin/backups`.

```
$linsrv = Add-VBRLinux -Name "172.18.4.67" -SSHUser Admin -SSHPassword P@$$w0rd
Add-VBRBackupRepository -Name "Linux Repository" -Server $linsrv -Type LinuxLocal -Folder "/home/Admin/backups/"
```

Perform the following steps:

1. Run the [`Add-VBRLinux`](add-vbrlinux.md) cmdlet. Specify the `Name`, `SSHUser` and `SSHPassword` parameter values. Save the result to the `$linsrv` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$linsrv` variable as the `Server` parameter value.
   - Set the `LinuxLocal` option for the `Type` parameter.
   - Specify the `Folder` parameter value.

:::

::: example
### Example 3. Adding Linux Server with Hardened Repository Role

This example shows how to add the `198.51.100.5` Linux server as a hardened repository. The cmdlet will add the backup repository with the following settings:

- The Linux server is added with temporary elevate to root and failover to su single-use credentials.
- Veeam Backup & Replication will store backup files in the folder located in the following path: `/home/Admin/backups`.
- Immutability period is set to 21 days.

```
$linsrv = Add-VBRLinux -Name "198.51.100.5" -SSHUser "User" -SSHPassword "qwerty" -SSHElevateToRoot -SSHTempCredentials -SSHFailoverToSu -SSHRootPassword "passcode"
Add-VBRBackupRepository -Folder "/home/Admin/backups/" -Type Hardened -Name "Hardened Repository" -Server $linsrv -EnableBackupImmutability -ImmutabilityPeriod 21
```

Perform the following steps:

1. Run the [`Add-VBRLinux`](add-vbrlinux.md) cmdlet. Specify the necessary parameters. Save the result to the `$linsrv` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Folder` parameter value.
   - Set the `Hardened` option for the `Type` parameter.
   - Specify the `Name` parameter value.
   - Set the `$linsrv` variable as the `Server` parameter value.
   - Provide the `EnableBackupImmutability` parameter.
   - Specify the `ImmutabilityPeriod` parameter value.

:::

::: example
### Example 4. Adding SMB (CIFS) Shared Folder as Backup Repository

This example shows how to add an SMB (CIFS) shared folder on a Windows server as the `Backups Vol 01` backup repository. The cmdlet will add the backup repository with the following settings:

- Veeam Backup & Replication uses credentials to authenticate against the shared folder.
- The server type is set to `CifsShare`.
- The `\\nimble\Backups` folder is used as the backup repository.
- The same server is used as a mount server.
- The `ImportBackup` parameter is set to import the existing backup files.
- The maximum allowed number of concurrent tasks is set to `6`.

```
$server = Get-VBRServer -Name "TestServer05"
$mountserver = Get-VBRServer -Name "TestServer05"
$administrator = Get-VBRCredentials -Name "Administrator"
Add-VBRBackupRepository -Type CifsShare -Name "Nimble Script Share" -Server $server -Folder "\\nimble\Backups" -MountServer $mountserver -ImportBackup:$true -LimitConcurrentJobs -MaxConcurrentJobs 6 -Credentials $administrator
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$mountserver` variable.
3. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$administrator` variable.
4. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Set the `CifsShare` option for the `Type` parameter.
   - Specify the `Name` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Folder` parameter value.
   - Set the `$mountserver` variable as the `MountServer` parameter value.
   - Set the `ImportBackup` parameter to `$true`.
   - Provide the `LimitConcurrentJobs` parameter.
   - Specify the `MaxConcurrentJobs` parameter value.
   - Set the `$administrator` variable as the `Credentials` parameter value.

:::

::: example
### Example 5. Adding Dedupe Storage Appliance as Backup Repository

This example shows how to add a Dell Data Domain storage appliance as a backup repository. The cmdlet will add the backup repository with the following settings:

- Dell Data Domain connects to the `WinSrv05` explicitly set as a gateway server.
- The `DFC` prefix is not set to allow Veeam Backup & Replication to communicate with Dell Data Domain storage over the TCP/IP protocol.
- Veeam Backup & Replication will store backup files in the folder located in the following path: `ddboost://10.0.0.80:storage/`.
- The Username/Password is used to get access to the appliance.

```
$server = Get-VBRServer -Name "WinSrv05"
Add-VBRBackupRepository -Folder ddboost://10.0.0.80:storage/ -Type DataDomain -DDServerName 10.0.0.80 -Server $server -UserName sysadmin -Password Pa55word
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Folder` parameter value.
   - Specify the `Type` parameter value.
   - Specify the `DDServerName` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `UserName` parameter value.
   - Specify the `Password` parameter value.

:::

::: example
### Example 6. Adding Backup Repository on Rotated Drive

This example shows how to add backup repository on a rotated drive connected to a Windows server. The cmdlet will add the backup repository with the following settings:

- The server type is set to `WinLocal`.
- Veeam Backup & Replication will store backup files in the folder located in the following path: `F:\Repo`.

```
$server = Get-VBRServer -Name "WinSrv05"
Add-VBRBackupRepository -Name RDX -Type WinLocal -RotatedDrive -Description "Rotated drive" -Server $server -Folder F:\Repo
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `WinLocal` option for the `Type` parameter value.
   - Provide the `RotatedDrive` parameter.
   - Specify the `Description` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Folder` parameter value.

:::

::: example
### Example 7. Adding Quantum DXi Storage Appliance as Backup Repository

This example shows how to add a Quantum DXi storage appliance as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: `/shares/Quantum-Share-01.`

```
$server = Get-VBRServer -Name "WinSrv05"
Add-VBRBackupRepository -Name "Quantum DXi" -Type Quantum -Folder "/shares/Quantum-Share-01" -Server $server
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `Quantum` option for the `Type` parameter.
   - Specify the `Folder` parameter value.
   - Set the `$server` variable as the `Server` parameter value.

:::

::: example
### Example 8. Adding ExaGrid Share as Backup Repository

This example shows how to add ExaGrid as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: `/home/Admin/Share01-07/MyRepo`. The pattern of this folder path consists of the following elements:

1. `/home`: A home directory.
2. `/Admin`: Must be the same as the user name that you use to authenticate against the Linux server when you add it to Veeam Backup & Replication. In our example it is specified by the `SSHUser` parameter of the [`Add-VBRLinux`](add-vbrlinux.md) cmdlet.
3. `/Share01-07`: The folder that you must create on the Exagrid appliances beforehand.
4. [Optional] /`MyRepo/`: Subfolder that you may want to create in the `Share01-07` folder.

```
$srv = Add-VBRLinux -Name "172.18.4.67" -SSHUser Admin -SSHPassword P@$$w0rd
Add-VBRBackupRepository -Name ExaGrid -Server $srv -Type ExaGrid -Folder "/home/Admin/Share01-07/MyRepo/"
```

Perform the following steps:

1. Run the [`Add-VBRLinux`](add-vbrlinux.md) cmdlet. Specify the `Name`, `SSHUser` and `SSHPassword` parameter values. Save the result to the `$srv` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$srv` variable as the `Server` parameter value.
   - Set the `ExaGrid` option for the `Type` parameter.
   - Specify the `Folder` parameter value.

:::

::: example
### Example 9. Adding HPE StoreOnce as Backup Repository

This example shows how to add HPE StoreOnce as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: `storeonce://HPEStoreO01-dl.local:Store-015/.` The pattern of this folder path consists of the following elements:

1. `//HPEStoreO01-dl.local`: The name of HPE StoreOnce.
2. `:Store-015@/`: The name of the HPE StoreOnce Catalyst Store.

  **Note**: It is not recommended to specify any subfolders in this folder, since currently Veeam Backup & Replication is able to display only the name of HPE StoreOnce Catalyst Store. If you indeed want to specify a subfolder, review this [KB article](https://www.veeam.com/kb2987) but keep in mind that you will not be able to manage the backup repository with the user interface of Veeam Backup & Replication.

```
$creds = Get-VBRCredentials -Name "HPEStorOnce"
Add-VBRBackupRepository -Type HPStoreOnceIntegration -Name "Atlanta Repository" -StoreOnceServerName "HPEStoreO01-dl.local" -Folder "storeonce://HPEStoreO01-dl.local:Store-015@/" -Credentials $creds
```

Perform the following steps:

1. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$creds` variable.
2. Run the `Add-VBRBackupRepository` cmdlet. Specify the following settings:

   - Set the `HPStoreOnceIntegration` option for the `Type` parameter.
   - Specify the `Name` parameter value.
   - Specify the `StoreOnceServerName` parameter value.
   - Specify the `Folder` parameter value.
   - Set the `$creds` variable as the `Credentials` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRCredentials`](get-vbrcredentials.md)
- [`Add-VBRLinux`](add-vbrlinux.md)