---
title: "New-VBRComputerDestinationOptions"
description: "Creates the target location settings for backup policies. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: Local Shared Repository This cmdlet creates the VB"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcomputerdestinationoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Target Settings > New-VBRComputerDestinationOptions"
dateModified: "2026-08-19"
---

# New-VBRComputerDestinationOptions

## Short Description
Creates the target location settings for backup policies.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Local</code></p>

```
New-VBRComputerDestinationOptions -LocalPath <String> -OSPlatform <VBRAgentType> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Shared</code></p>

```
New-VBRComputerDestinationOptions -OSPlatform <VBRAgentType> -NetworkFolderPath <String>
 [-TargetShareType <VBRDestinationTargetShareType>] [-UseNetworkCredentials]
 [-NetworkCredentials <CCredentials>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Repository</code></p>

```
New-VBRComputerDestinationOptions -OSPlatform <VBRAgentType> [-BackupServerName <String>]
 -BackupRepository <CBackupRepository> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the `VBRComputerDestinationOptions` object that contains the target location settings for the backup policy. Veeam Backup & Replication applies this policy to the protected computers.

Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet to get the repository.

## 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>Use this option if you want to save a backup on either of the following types of a backup repository:</p><ul><li><p>Backup repository managed by the Veeam backup server.</p></li><li><p>Veeam Cloud Connect repository.</p><p><strong>Note</strong>: Cloud repositories added from Cloud Director tenant are not supported.</p></li></ul><p>Accepts the <code>CBackupRepository</code> object. To get 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>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">BackupServerName</span></p>
        </td>
        <td>
          <p>Specifies the DNS name or an external IP address of the Veeam backup server that manages the target backup repository.</p><p><strong>Note</strong>: You can use only the Veeam backup server where the Veeam Agent backup job is configured.</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">LocalPath</span></p>
        </td>
        <td>
          <p>Use this parameter if you want to keep backups on the following target locations:</p><ul><li>On a removable storage device attached to a protected computer.</li><li>On a local drive of a protected computer.</li></ul>
        </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">NetworkCredentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials which Veeam Agent will use to authenticate to the network shared folder.</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">NetworkFolderPath</span></p>
        </td>
        <td>
          <p>Use this option if you want to keep backups in a network shared folder.</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">OSPlatform</span></p>
        </td>
        <td>
          <p>Specifies the OS of the protected computers:</p><ul><li><p><code>Windows</code>: for Windows computers.</p></li><li><p><code>Linux</code>: for Linux computers.</p></li><li><p><code>Mac</code>: for macOS computers.</p><p><strong>Note</strong>: Indexing for macOS computers is not supported in current version of Veeam PowerShell.</p></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAgentType</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">TargetShareType</span></p>
        </td>
        <td>
          <p>Specifies the protocol that you will use to keep backups on shared folders.</p><ul><li><code>SMB</code></li><li><code>NFS</code></li></ul><p><strong>Note</strong>: The NFS protocol type does not work for Windows computers.</p><p>Default: <code>SMB</code></p>
        </td>
        <td style="width:10%;">
          <p><code>VBRDestinationTargetShareType</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">UseNetworkCredentials</span></p>
        </td>
        <td>
          <p>Defines that the network shared folder requires authentication.</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
This cmdlet returns the `VBRComputerDestinationOptions` object that contains the target location settings for the backup policy.

## Examples

::: example
### Example 1. Creating Target Location Settings for Veeam Agent Backup Policy (Local Drive)

This command creates target location settings for the backup policy that Veeam Agent job applies to the protected computers. The job will save the backups to a local drive of the protected computer. Use the `LocalPath` parameter to specify the local drive path settings.

```
New-VBRComputerDestinationOptions -LocalPath "D:\Backup" -OSPlatform Windows
```

:::

::: example
### Example 2. Creating Target Location Settings for Veeam Agent Backup Policy (Network Shared Folder)

This example shows how to create target location settings for the backup policy that Veeam Agent job applies to the protected computers. The job will save the backups to the network shared folder.

```
$creds = Get-Credential
New-VBRComputerDestinationOptions -NetworkFolderPath "172.17.53.14:/Veeam" -OSPlatform Linux -TargetShareType NFS -UseNetworkCredentials -NetworkCredentials $creds
```

Perform the following steps:

1. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.4) cmdlet. Save the result to the `$creds` variable.
2. Run the `New-VBRComputerDestinationOptions` cmdlet. Specify the following settings:

   - Specify the `NetworkFolderPath` parameter value.
   - Set the `Linux` value for the `OSPlatform` parameter.
   - Set the `NFS` value for the `TargetShareType` parameter.
   - Provide the `UseNetworkCredentials` parameter.
   - Set the `$creds` variable as the `NetworkCredentials` parameter value.

:::

::: example
### Example 3. Creating Target Location Settings for Veeam Agent Backup Policy (Backup Repository)

This example shows how to create target location settings for the backup policy that Veeam Agent job applies to the protected computers. The job will save the backups to the backup repository managed by the Veeam backup server.

```
$repository = Get-VBRBackupRepository -Name "Default Backup Repository"
New-VBRComputerDestinationOptions -OSPlatform Windows -BackupRepository $repository -BackupServerName "Repository 01"
```

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-VBRComputerDestinationOptions` cmdlet. Set the `Windows` option for the `OSPlatform` parameter. Set the `$repository` variable as the `BackupRepository` parameter value. Specify the `BackupServerName` parameter value.

:::

## Related Commands

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