---
title: "Set-VBRJobProxy"
description: "Modifies settings of a backup proxy. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: Manual Auto This cmdlet modifies settings of a backup pr"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrjobproxy.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Proxies > Set-VBRJobProxy"
dateModified: "2026-08-19"
---

# Set-VBRJobProxy

## Short Description
Modifies settings of a backup proxy.

**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>Manual</code></p>

```
Set-VBRJobProxy -Job <CBackupJob[]> -Proxy <IProxy[]> [-Target] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Auto</code></p>

```
Set-VBRJobProxy -Job <CBackupJob[]> [-AutoDetect] [-Target] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies settings of a backup proxy.

You can run this cmdlet with backup jobs and replica jobs.

::: 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.

:::

::: important

If you want to set a custom proxy, make sure that the proxy server is added to the backup infrastructure console, otherwise you will not be able to assign it to the job. The custom proxy server must be configured appropriately. For more information on proxy server settings, see [Adding VMware Backup Proxies](https://helpcenter.veeam.com/docs/vbr/userguide/add_vmware_proxy.html?ver=13) section in the Veeam Backup & Replication User Guide.

:::

## 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">AutoDetect</span></p>
        </td>
        <td>
          <p>Defines that the automatic selection mode is enabled.</p><p>If you provide this parameter, the proxy server selection mode will be set to automatic. Otherwise, you must specify the custom proxy server.</p><p>Use the <code>Proxy</code> parameter to specify the custom proxy server.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">Job</span></p>
        </td>
        <td>
          <p>Specifies an array of jobs. The cmdlet will return proxies assigned to these jobs.</p><p>Accepts the <code>CBackupJob[]</code> object. To get this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupJob[]</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 (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Proxy</span></p>
        </td>
        <td>
          <p>Specifies an array of proxies you want to assign to the job.</p><p>Accepts the <code>IProxy[]</code> object. To get this object, run the <a href="get-vbrviproxy.md"><code>Get-VBRViProxy</code></a> or <a href="get-vbrhvproxy.md"><code>Get-VBRHvProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IProxy[]</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">Target</span></p>
        </td>
        <td>
          <p>Defines that the autodetect option will be enabled for the target proxy server.</p><p>If you provide this parameter, the automatic selection mode will be enabled for the target proxy server.</p><p>Otherwise, the automatic selection mode will be enabled for the source proxy server.</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>
    </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 `CBackupJob[]` object that contains an array of jobs.

## Examples

::: example
### Example 1. Assigning Hyper-V Proxy to Job [Using Variable]

This example shows how to assign the custom Hyper-V target proxy to the `Backup Copy` job. The name of the proxy is `Local Backup Proxy`. The `Target` parameter is set to enable target proxy allocation.

```
$job = Get-VBRJob -Name "Backup Copy"
$proxy = Get-VBRHvProxy -Name "Local Backup Proxy"
Set-VBRJobProxy -Job $job -Proxy $proxy -Target
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`Get-VBRHvProxy`](get-vbrhvproxy.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$proxy` variable.
3. Run the `Set-VBRJobProxy` cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$proxy` variable as the `Proxy` parameter value. Provide the `Target` parameter.

:::

::: example
### Example 2. Assigning VMware Proxies to Job [Using Pipeline]

This example shows how to assign the custom VMware source proxy to the `Backup Job 01` and `Backup Job 02` backup jobs. The name of the proxy is `Local Backup Proxy`. The `Target` parameter is not set to enable the source proxy allocation.

```
$proxy = Get-VBRViProxy -Name "Local Backup Proxy"
Get-VBRJob -Name "Backup Job 01", "Backup Job 02" | Set-VBRJobProxy -Proxy $proxy
```

Perform the following steps:

1. Run the [`Get-VBRViProxy`](get-vbrviproxy.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter values.
3. Pipe the cmdlet output to the `Set-VBRJobProxy` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value.

:::

::: example
### Example 3. Setting Automatic Proxy Selection to Job [Using Pipeline]

This example shows how to set the automatic proxy selection to the `Backup Job 01` and `Backup Job 02` backup jobs. The `Target` parameter is not set to enable the source proxy allocation.

```
Get-VBRJob -Name "Backup Job 01", "Backup Job 02" | Set-VBRJobProxy -AutoDetect
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter values.
2. Pipe the cmdlet output to the `Set-VBRJobProxy` cmdlet. Provide the `AutoDetect` parameter.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`Get-VBRViProxy`](get-vbrviproxy.md)
- [`Get-VBRHvProxy`](get-vbrhvproxy.md)