---
title: "Add-VBOProxy"
description: "This cmdlet adds a backup proxy server to the Veeam Backup for Microsoft 365 backup infrastructure."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/add-vboproxy.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > Add-VBOProxy"
dateModified: "2026-08-21"
---

# Add-VBOProxy

## Short Description
Adds a backup proxy server to the Veeam Backup for Microsoft 365 infrastructure.

## Syntax

This cmdlet provides the following parameter sets:

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

```
Add-VBOProxy -Hostname <String> [-Credential <PSCredential>] [-WindowsCredential <PSCredential>]
 [-Port <Int32>] [-Description <String>] [-Force] [-ThreadsNumber <Int32>] [-EnableNetworkThrottling]
 [-ThrottlingValue <UInt32>] [-ThrottlingUnit <VBOThrottlingUnit>] [-InternetProxyMode <VBOInternetProxyMode>]
 [-CustomInternetProxyHostName <String>] [-CustomInternetProxyPort <UInt16>]
 [-UseCustomInternetProxyAuthentication] [-CustomInternetProxyCredential <PSCredential>] [-UseDomainNetwork]
 [-ServiceCredential <PSCredential>] [-CreateServiceAccount] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>LinuxParameterSet</code></p>

```
Add-VBOProxy -Hostname <String> [-Port <Int32>] [-Description <String>] [-Force] [-ThreadsNumber <Int32>]
 [-EnableNetworkThrottling] [-ThrottlingValue <UInt32>] [-ThrottlingUnit <VBOThrottlingUnit>]
 [-InternetProxyMode <VBOInternetProxyMode>] [-CustomInternetProxyHostName <String>]
 [-CustomInternetProxyPort <UInt16>] [-UseCustomInternetProxyAuthentication]
 [-CustomInternetProxyCredential <PSCredential>] [-LinuxCredential <VBOLinuxCredential>]
 [-ServiceCredential <PSCredential>] [-CreateServiceAccount] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet adds a backup proxy server to the Veeam Backup for Microsoft 365 backup infrastructure.

## 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">CreateServiceAccount</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create a service account and automatically grant the required permissions to this account.</p><p>Default: <em>False</em></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">Credential</span></p>
        </td>
        <td>
          <p>Specifies Windows credentials. The cmdlet will use these credentials to connect to the Windows-based backup proxy server.</p><p>If you omit this parameter, the cmdlet will use the Windows credentials under which you are currently logged in.</p><p><strong>Note</strong>: This parameter will be deprecated in future versions of Veeam Backup for Microsoft 365. Use the <code>WindowsCredential</code> parameter instead.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">CustomInternetProxyCredential</span></p>
        </td>
        <td>
          <p>For the <code>InternetProxyMode</code> parameter with the <code>Custom</code> option.</p><p>Specifies credentials that you want to use for authentication to the internet proxy server.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">CustomInternetProxyHostName</span></p>
        </td>
        <td>
          <p>For the <code>InternetProxyMode</code> parameter with the <code>Custom</code> option.</p><p>Specifies a DNS name or an IP address of the internet proxy server that you want to add.</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">CustomInternetProxyPort</span></p>
        </td>
        <td>
          <p>For the <code>InternetProxyMode</code> parameter with the <code>Custom</code> option.</p><p>Specifies a port number. A backup proxy will use this port to connect to the internet proxy server.</p><p>Default: <em>3128</em></p>
        </td>
        <td style="width:10%;">
          <p><code>UInt16</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 a description of the backup proxy server.</p><p>The default description contains information on the user who added the backup proxy server, date and time when the backup proxy server was added.</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">EnableNetworkThrottling</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will limit the inbound traffic to the backup proxy server for performance optimization.</p><p>Default: <em>False</em></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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a backup proxy server without showing warnings in the PowerShell console.</p><p>If you do not provide the parameter, the cmdlet will prompt you to confirm the operation.</p><p>Default: <em>False</em></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">Hostname</span></p>
        </td>
        <td>
          <p>Specifies a DNS name or an IP address of a backup proxy server that you want to add.</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">InternetProxyMode</span></p>
        </td>
        <td>
          <p>Specifies settings of an internet proxy server. Veeam Backup for Microsoft 365 will assign this internet proxy server to a backup proxy that does not have direct access to the internet.</p><ul><li><p><code>Custom</code>: Use this option to specify connection settings for an internet proxy server explicitly.</p><p>Use the following parameters to specify these settings:</p><ul><li><code>CustomInternetProxyHostName</code></li><li><code>CustomInternetProxyPort</code></li><li><code>UseCustomInternetProxyAuthentication</code></li><li><code>CustomInternetProxyCredential</code></li></ul></li><li><p><code>ManagementServerProxy</code>: Use this option if you want an internet proxy server to use the connection settings that are specified in the global internet proxy server settings.</p></li><li><p><code>None</code>: Use this option if you do not want to assign an internet proxy server to a backup proxy server.</p></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOInternetProxyMode</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">LinuxCredential</span></p>
        </td>
        <td>
          <p>Specifies Linux credentials.</p><p>The cmdlet will use these credentials to connect to the Linux-based backup proxy server.</p><p>Accepts the <a href="vbolinuxcredential.md"><code>VBOLinuxCredential</code></a> object.</p><p>To get this object, run the <a href="new-vbolinuxcredential.md"><code>New-VBOLinuxCredential</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbolinuxcredential.md"><code>VBOLinuxCredential</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">Port</span></p>
        </td>
        <td>
          <p>Specifies a port number. The cmdlet will use this port number to connect to the backup proxy server.</p><p>Default: <em>9193</em></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">ServiceCredential</span></p>
        </td>
        <td>
          <p>Specifies credentials of a service account. The cmdlet will use these credentials to run <em>Veeam Backup for Microsoft 365</em> <em>Proxy Service</em>.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">ThreadsNumber</span></p>
        </td>
        <td>
          <p><strong>Note</strong>: This parameter will be deprecated in future versions of Veeam Backup for Microsoft 365.</p><p>Specifies a number of threads that the backup proxy server will simultaneously run to process backup data.</p><p>Default: <em>64</em></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">ThrottlingUnit</span></p>
        </td>
        <td>
          <p>For the <code>EnableNetworkThrottling</code> parameter.</p><p>Specifies a measuring unit for the inbound traffic threshold: <em>Mbps</em>, <em>MBs</em> or <em>KBs</em>.</p><p>Default: <em>Mbps</em></p>
        </td>
        <td style="width:10%;">
          <p><code>VBOThrottlingUnit</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">ThrottlingValue</span></p>
        </td>
        <td>
          <p>For the <code>EnableNetworkThrottling</code> parameter.</p><p>Specifies a threshold for the inbound traffic to the backup proxy server.</p><p>Default: <em>0</em></p>
        </td>
        <td style="width:10%;">
          <p><code>UInt32</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">UseCustomInternetProxyAuthentication</span></p>
        </td>
        <td>
          <p>For the <code>InternetProxyMode</code> parameter with the <code>Custom</code> option.</p><p>Defines that a backup proxy will use authentication for connecting to the internet proxy server.</p><p>Default: <em>False</em></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">UseDomainNetwork</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a domain backup proxy, that is, a backup proxy server that resides in the same domain as the Veeam Backup for Microsoft 365 server or in a trusted domain.</p><p>If you omit this parameter, the cmdlet will add a workgroup backup proxy, that is, a backup proxy server that resides in a workgroup.</p><p>Default: <em>False</em></p><p>For more information about backup proxy server types, see the <a href="https://helpcenter.veeam.com/docs/vbo365/guide/vbo_backup_proxy_servers.html?ver=8">Backup Proxy Servers</a> section of the Veeam Backup for Microsoft 365 User Guide.</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">WindowsCredential</span></p>
        </td>
        <td>
          <p>Specifies Windows credentials. The cmdlet will use these credentials to connect to the Windows-based backup proxy server.</p><p>If you omit this parameter, the cmdlet will use the Windows credentials under which you are currently logged in.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOProxy`](vboproxy.md) object that contains settings of a backup proxy server added to the Veeam Backup for Microsoft 365 backup infrastructure.

## Examples

::: example
### Example 1: Adding Backup Proxy Server Using Current Windows Account Credentials

This command adds a Windows-based backup proxy server with `172.70.53.53` IP address to the Veeam Backup for Microsoft 365 server. Veeam Backup for Microsoft 365 will use the account under which you are currently logged in to Windows server to connect to the backup proxy server. The backup proxy server and Veeam Backup for Microsoft 365 server reside in the same domain or in trusted domains.

```
Add-VBOProxy -Hostname 172.70.53.53 -Port 9193 -UseDomainNetwork
```

:::

::: example
### Example 2: Adding Backup Proxy Server Using Specific Credentials

This example shows how to add a Windows-based backup proxy server with `172.70.53.53` IP address to the Veeam Backup for Microsoft 365 server with the following settings:

- Veeam Backup for Microsoft 365 will use the credentials that you provide to connect to the backup proxy server.
- Veeam Backup for Microsoft 365 will use the 9193 port number to connect to the backup proxy server.
- The backup proxy server will reside in a workgroup.

```
$serverCredentials = Get-Credential
Add-VBOProxy -Hostname 172.70.53.53 -WindowsCredential $serverCredentials -Port 9193
```

Perform the following steps:

1. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet. Enter the credentials you want to use to connect to the backup proxy server. Save the result to the `$serverCredentials` variable.
2. Run the `Add-VBOProxy` cmdlet. Set the `$serverCredentials` variable as the `WindowsCredential` parameter value. Specify the `Port` parameter value.

:::

::: example
### Example 3: Adding Backup Proxy Server with Internet Proxy Server Settings

This command adds a Windows-based backup proxy server with the `172.70.53.53` IP address to the Veeam Backup for Microsoft 365 server with the following settings:

- Veeam Backup for Microsoft 365 will use the account under which you are currently logged in to Windows server to connect to the backup proxy server.
- The backup proxy will use the `internetProxy.local` internet proxy server to access the internet.
- The backup proxy will use the 3128 port to connect to the `CustomInternetProxyPort` internet proxy server.

```
Add-VBOProxy -Hostname 172.70.53.53 -InternetProxyMode Custom -CustomInternetProxyHostName internetProxy.local -CustomInternetProxyPort 3128
```

:::

::: example
### Example 4: Adding Backup Proxy Server with Inbound Traffic Limitations

This command adds a Windows-based backup proxy server with the `172.70.53.53` IP address to the Veeam Backup for Microsoft 365 server. To connect to the backup proxy server, the cmdlet will use the account under which you are currently logged in.

The threshold for the inbound traffic to the backup proxy will be set to 10 Mbps.

```
Add-VBOProxy -Hostname 172.70.53.53 -EnableNetworkThrottling -ThrottlingValue 10 -ThrottlingUnit Mbps
```

:::

::: example
### Example 5: Adding Linux-Based Backup Proxy Server

This example shows how to add a Linux-based backup proxy server to the Veeam Backup for Microsoft 365 server with the following settings:

- Veeam Backup for Microsoft 365 will use Linux credentials that you provide to connect to the backup proxy server.
- Veeam Backup for Microsoft 365 will use the 9193 port number to connect to the backup proxy server.

```
$linuxpwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
$linuxcredentials = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot:$true -Password $linuxpwd
Add-VBOProxy -Hostname linux01 -Port 9193 -LinuxCredential $linuxcredentials
```

Perform the following steps:

1. Run the [`ConvertTo-SecureString`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/convertto-securestring) cmdlet. Specify the necessary parameters. Save the result to the `$linuxpwd` variable.
2. Run the [`New-VBOLinuxCredential`](new-vbolinuxcredential.md) cmdlet. Specify the necessary parameters. Save the result to the `$linuxcredentials` variable.
3. Run the `Add-VBOProxy` cmdlet. Specify the `Hostname` parameter value. Specify the `Port` parameter value. Set the `$linuxcredentials` variable as the `LinuxCredential` parameter value.

:::

## Related Commands

- [`New-VBOLinuxCredential`](new-vbolinuxcredential.md)
- [``Get-Credential``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential)
- [``ConvertTo-SecureString``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/convertto-securestring)