---
title: "Update-VBOProxy"
description: "This cmdlet upgrades an array of backup proxy servers. You may need this if you have upgraded Veeam Backup for Microsoft 365 to a new version and all backup proxy servers configured in your environment are marked as Out of Date."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/update-vboproxy.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > Update-VBOProxy"
dateModified: "2026-08-21"
---

# Update-VBOProxy

## Short Description
Upgrades backup proxy servers.

## Syntax
```
Update-VBOProxy [-Credential <PSCredential>] [-WindowsCredential <PSCredential>]
 [-LinuxCredential <VBOLinuxCredential>] -Proxy <VBOProxy[]> [<CommonParameters>]
```

## Detailed Description
This cmdlet upgrades an array of backup proxy servers. You may need this if you have upgraded Veeam Backup for Microsoft 365 to a new version and all backup proxy servers configured in your environment are marked as *Out of Date*.

## 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">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">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">Proxy</span></p>
        </td>
        <td>
          <p>Specifies an array of backup proxy servers. The cmdlet will upgrade these backup proxy servers.</p><p>Accepts the <a href="vboproxy.md"><code>VBOProxy</code></a><code>[]</code> object.</p><p>To get this object, run the <a href="get-vboproxy.md"><code>Get-VBOProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxy.md"><code>VBOProxy[]</code></a></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">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.

## Examples

::: example
### Example 1: Upgrading All Backup Proxy Servers

This example shows how to upgrade all backup proxy servers that are added to Veeam Backup for Microsoft 365.

```
$proxy = Get-VBOProxy
Update-VBOProxy -Proxy $proxy
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Save the result to the `$proxy` variable.
2. Run the `Update-VBOProxy` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value.

:::

::: example
### Example 2: Upgrading Windows-Based Backup Proxy Server

This example shows how to upgrade the `proxy03.tech.local` backup proxy server that is added to Veeam Backup for Microsoft 365. To connect to the backup proxy server, the cmdlet will use current account credentials.

```
$proxy = Get-VBOProxy -Hostname proxy03.tech.local
Update-VBOProxy -Proxy $proxy
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
2. Run the `Update-VBOProxy` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value.

:::

::: example
### Example 3: Upgrading Windows-Based Backup Proxy Server with Windows Credentials

This example shows how to upgrade the `proxy03.tech.local` backup proxy server that is added to Veeam Backup for Microsoft 365. To connect to the backup proxy server, the cmdlet will use the backup proxy server credentials.

```
$proxy = Get-VBOProxy -Hostname proxy03.tech.local
$credentials = Get-Credential
Update-VBOProxy -Proxy $proxy -WindowsCredential $credentials
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet to create a credential object. Enter credentials that will be used to connect to the proxy server. Save the result to the `$credentials` variable.
3. Run the `Update-VBOProxy` cmdlet. Specify the `$proxy` variable as the `Proxy` parameter value. Specify `$credentials` variable as the `WindowsCredential` parameter value.

:::

::: example
### Example 4: Upgrading Linux-Based Backup Proxy Server

This example shows how to upgrade the `linux01` backup proxy server that is added to Veeam Backup for Microsoft 365.

```
$linuxpwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
$linuxcredentials = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot:$true -Password $linuxpwd
$proxy = Get-VBOProxy -Hostname linux01
Update-VBOProxy -Proxy $proxy -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 [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
4. Run the `Update-VBOProxy` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value. Set the `$linuxcredentials` variable as the `LinuxCredential` parameter value.

:::

## Related Commands

- [`Get-VBOProxy`](get-vboproxy.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)
- [`New-VBOLinuxCredential`](new-vbolinuxcredential.md)