---
title: "Set-VBOProxyMaintenance"
description: "This cmdlet enables or disables maintenance mode for backup proxy servers that are already added to a backup proxy pool. If the maintenance mode is enabled for a backup proxy server, Veeam Backup for Microsoft 365 re-assigns all roles of this..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vboproxymaintenance.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Pools > Set-VBOProxyMaintenance"
dateModified: "2026-08-21"
---

# Set-VBOProxyMaintenance

## Short Description
Enables or disables maintenance mode for backup proxy servers that are already added to a backup proxy pool.

## Syntax
```
Set-VBOProxyMaintenance [-WindowsCredential <PSCredential>] [-LinuxCredential <VBOLinuxCredential>]
 -Proxy <VBOProxy[]> [-Enable] [<CommonParameters>]
```

## Detailed Description
This cmdlet enables or disables maintenance mode for backup proxy servers that are already added to a backup proxy pool.

If the maintenance mode is enabled for a backup proxy server, Veeam Backup for Microsoft 365 re-assigns all roles of this backup proxy server to another backup proxy server within the same backup proxy pool. All tasks of the unavailable backup proxy server will be continued smoothly by another backup proxy server. Veeam Backup for Microsoft 365 cannot assign new objects for processing to a backup proxy server in the maintenance mode.

You may need to enable the maintenance mode for a backup proxy server, for example, if you want to upgrade a machine assigned the backup proxy server role, or perform other service operations.

## 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">Enable</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the maintenance mode for the specified backup proxy servers.</p><p>Default: <em>True</em></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">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 for which you want to enable or disable the maintenance mode.</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: Enabling Maintenance Mode

This example shows how to enable the maintenance mode for the `support.east.local` backup proxy server.

```
$serverCredentials = Get-Credential
$proxy = Get-VBOProxy -Hostname support.east.local
Set-VBOProxyMaintenance -Proxy $proxy -WindowsCredential $serverCredentials -Enable:$true
```

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 [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
3. Run the `Set-VBOProxyMaintenance` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value. Set the `$serverCredentials` variable as the `WindowsCredential` parameter value. Set the `true` value for the `Enable` parameter.

:::

::: example
### Example 2: Disabling Maintenance Mode

This example shows how to disable the maintenance mode for the `linux01` backup proxy server.

```
$linuxpwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
$linuxcredentials = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot:$true -Password $linuxpwd
$proxy = Get-VBOProxy -Hostname linux01
Set-VBOProxyMaintenance -Proxy $proxy -LinuxCredential $linuxcredentials -Enable:$false
```

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 `Set-VBOProxyMaintenance` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value. Set the `$linuxcredentials` variable as the `LinuxCredential` parameter value. Set the `false` value for the `Enable` parameter.

:::

## 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)