---
title: "Set-VBRComputerDestinationOptions"
description: "This cmdlet modifies the target location settings for the backup policy that Veeam Agent job applies to the protected computers. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-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 > Set-VBRComputerDestinationOptions"
dateModified: "2026-08-19"
---

# Set-VBRComputerDestinationOptions

## Short Description
Modifies the target location for Veeam Agent 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>

```
Set-VBRComputerDestinationOptions -Options <VBRComputerDestinationOptions> -LocalPath <String> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Shared</code></p>

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

```
Set-VBRComputerDestinationOptions -Options <VBRComputerDestinationOptions> [-BackupServerName <String>]
 [-BackupRepository <CBackupRepository>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies the target location settings for the backup policy that Veeam Agent job applies to the protected computers.

::: 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>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>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">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>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 the target location settings that you want to modify.</p><p>Accepts the <code>VBRComputerDestinationOptions</code> object. To get this object, run the <a href="new-vbrcomputerdestinationoptions.md"><code>New-VBRComputerDestinationOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerDestinationOptions</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">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>
        </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
### Modifying Target Location Settings for Veeam Agent Backup Policy

This example shows how to modify 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.

```
$job = Get-VBRComputerBackupJob -Name "WinPolicy"
$destination = $job.DestinationOptions
$repository = Get-VBRBackupRepository -Name "Repository"
Set-VBRComputerDestinationOptions -Options $destination -BackupRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRComputerBackupJob`](get-vbrcomputerbackupjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Get the `DestinationOptions` property of the `$job` variable. Save the result to the `$destination` variable.
3. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
4. Run the `Set-VBRComputerDestinationOptions` cmdlet. Set the `$destination` variable as the `Options` parameter value. Set the `$repository` variable as the `BackupRepository` parameter value.

:::

## Related Commands

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