---
title: "Set-VBOConfigurationParameter"
description: "This cmdlet allows you to configure parameters of the controller, backup proxy servers and backup proxy pools. Veeam Backup for Microsoft 365 saves configuration parameters of the Veeam Backup for Microsoft 365 controller to the Config.xml file..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vboconfigurationparameter.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Managing Veeam Backup for Microsoft 365 > Set-VBOConfigurationParameter"
dateModified: "2026-08-21"
---

# Set-VBOConfigurationParameter

## Short Description
Modifies configuration of the Veeam Backup for Microsoft 365 controller, backup proxy servers and backup proxy pools.

## Syntax
```
Set-VBOConfigurationParameter [-WindowsCredential <PSCredential>] [-LinuxCredential <VBOLinuxCredential>]
 [-Proxy <VBOProxy>] [-ProxyPool <VBOProxyPool>] -XPath <String> -Key <String> [-Value <String>]
 [-RevertToDefault] [-Restart] [-Controller] [<CommonParameters>]
```

## Detailed Description
This cmdlet allows you to configure parameters of the controller, backup proxy servers and backup proxy pools. Veeam Backup for Microsoft 365 saves configuration parameters of the Veeam Backup for Microsoft 365 controller to the *Config.xml* file, configuration parameters of backup proxy servers and backup proxy pools — to the *Proxy.xml* files.

To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

::: note

To enable the TLS encryption for the PostgreSQL instance traffic, use the following values for the `Key` parameter:

- `TlsEnabled`. Use this parameter attribute to enable the TLS encryption for the PostgreSQL instance traffic.
- `CertificateThumbprint`. Use this parameter attribute to provide the certificate thumbprint.

Consider that to enable the TLS encryption for the PostgreSQL instance traffic, you must specify both parameter attributes.

:::

## 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">Controller</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will configure parameters of the Veeam Backup for Microsoft 365 controller.</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">Key</span></p>
        </td>
        <td>
          <p>Specifies a name of the parameter attribute.</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">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><strong>Note</strong>: If the <code>ProxyPool</code> parameter is used, you must specify Linux credentials to connect to all Linux-based backup proxy servers in the backup proxy pool.</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 a backup proxy server.</p><p>The cmdlet will configure parameters of this backup proxy server.</p><p>Accepts the <a href="vboproxy.md"><code>VBOProxy</code></a> 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>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">ProxyPool</span></p>
        </td>
        <td>
          <p>Specifies a backup proxy pool.</p><p>The cmdlet will configure parameters of all backup proxy servers added to this backup proxy pool.</p><p>Accepts the <a href="vboproxypool.md"><code>VBOProxyPool</code></a> object.</p><p>To get this object, run the <a href="get-vboproxypool.md"><code>Get-VBOProxyPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxypool.md"><code>VBOProxyPool</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">Restart</span></p>
        </td>
        <td>
          <p>Defines that <em>Veeam Backup for Microsoft 365 Proxy Service</em> will be restarted to apply changes in configuration parameters.</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">RevertToDefault</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will revert the configuration parameters to the default values.</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">Value</span></p>
        </td>
        <td>
          <p>Specifies the parameter attribute value.</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">WindowsCredential</span></p>
        </td>
        <td>
          <p>Specifies Windows credentials.</p><p>The cmdlet will use these credentials to connect to the Windows-based backup proxy server.</p><p><strong>Note</strong>: If the <code>ProxyPool</code> parameter is used, you must specify Windows credentials to connect to all Windows-based backup proxy servers in the backup proxy pool.</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">XPath</span></p>
        </td>
        <td>
          <p>Specifies the <em>xpath</em> path in the <em>Config.xml</em> or <em>Proxy.xml</em> file.</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>
    </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: Configuring Controller Parameters

This example shows how to configure parameters of the Veeam Backup for Microsoft 365 controller.

```
$xpath = "/Veeam/Archiver/Server"
$key = "TestKey"
$value = "TestValue"
Set-VBOConfigurationParameter -XPath $xpath -Key $key -Value $value -Controller
```

Perform the following steps:

1. Enter values for the `XPath`, `Key` and `Value` parameters. Save them to the `$xpath`, `$key` and `$value` variables.
2. Run the `Set-VBOConfigurationParameter` cmdlet. Specify the following settings:

   - Set the `$xpath` variable as the `XPath` parameter value.
   - Set the `$key` variable as the `Key` parameter value.
   - Set the `$value` variable as the `Value` parameter value.
   - Provide the `Controller` parameter.

:::

::: example
### Example 2: Configuring Linux-Based Backup Proxy Server Parameters

This example shows how to configure parameters of the Linux-based backup proxy server.

```
$xpath = "/Veeam/Archiver/Server"
$key = "TestKey"
$value = "TestValue"
$vboproxy = Get-VBOProxy -Hostname linux02
$pwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
$linuxcredential = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot -IgnoreFingerprintCheck -Password $pwd
Set-VBOConfigurationParameter -XPath $xpath -Key $key -Value $value -Proxy $vboproxy -LinuxCredential $linuxcredential -Restart
```

Perform the following steps:

1. Enter values for the `XPath`, `Key` and `Value` parameters. Save them to the `$xpath`, `$key` and `$value` variables.
2. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$vboproxy` variable.
3. 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 `$pwd` variable.
4. Run the [`New-VBOLinuxCredential`](new-vbolinuxcredential.md) cmdlet. Specify the necessary parameters. Save the result to the `$linuxcredential` variable.
5. Run the `Set-VBOConfigurationParameter` cmdlet. Specify the following settings:

   - Set the `$xpath` variable as the `XPath` parameter value.
   - Set the `$key` variable as the `Key` parameter value.
   - Set the `$value` variable as the `Value` parameter value.
   - Set the `$vboproxy` variable as the `Proxy` parameter value.
   - Set the `$linuxcredential` variable as the `LinuxCredential` parameter value.
   - Provide the `Restart` parameter.

:::

::: example
### Example 3: Configuring Windows-Based Backup Proxy Server Parameters

This example shows how to configure parameters of the Windows-based backup proxy server.

```
$xpath = "/Veeam/Archiver/Server"
$key = "TestKey"
$value = "TestValue"
$vboproxy = Get-VBOProxy -Hostname 172.17.53.53
$winserverCredentials = Get-Credential
Set-VBOConfigurationParameter -XPath $xpath -Key $key -Value $value -Proxy $vboproxy -WindowsCredential $winserverCredentials -Restart
```

Perform the following steps:

1. Enter values for the `XPath`, `Key` and `Value` parameters. Save them to the `$xpath`, `$key` and `$value` variables.
2. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$vboproxy` variable.
3. 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 `$winserverCredentials` variable.
4. Run the `Set-VBOConfigurationParameter` cmdlet. Specify the following settings:

   - Set the `$xpath` variable as the `XPath` parameter value.
   - Set the `$key` variable as the `Key` parameter value.
   - Set the `$value` variable as the `Value` parameter value.
   - Set the `$vboproxy` variable as the `Proxy` parameter value.
   - Set the `$winserverCredentials` variable as the `WindowsCredential` parameter value.
   - Provide the `Restart` parameter.

:::

::: example
### Example 4: Configuring Backup Proxy Pool Parameters

This example shows how to configure parameters of backup proxy servers added to the backup proxy pool.

```
$xpath = "/Veeam/Archiver/Server"
$key = "TestKey"
$value = "TestValue"
$vboproxypool = Get-VBOProxyPool -Name "Pool"
$winserverCredentials = Get-Credential
$pwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
$linuxcredential = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot -IgnoreFingerprintCheck -Password $pwd
Set-VBOConfigurationParameter -XPath $xpath -Key $key -Value $value -ProxyPool $vboproxypool -WindowsCredential $winserverCredentials -LinuxCredential $linuxcredential -Restart
```

Perform the following steps:

1. Enter values for the `XPath`, `Key` and `Value` parameters. Save them to the `$xpath`, `$key` and `$value` variables.
2. Run the [`Get-VBOProxyPool`](get-vboproxypool.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vboproxypool` variable.
3. 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 `$winserverCredentials` variable.
4. 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 `$pwd` variable.
5. Run the [`New-VBOLinuxCredential`](new-vbolinuxcredential.md) cmdlet. Specify the necessary parameters. Save the result to the `$linuxcredential` variable.
6. Run the `Set-VBOConfigurationParameter` cmdlet. Specify the following settings:

   - Set the `$xpath` variable as the `XPath` parameter value.
   - Set the `$key` variable as the `Key` parameter value.
   - Set the `$value` variable as the `Value` parameter value.
   - Set the `$vboproxypool` variable as the `ProxyPool` parameter value.
   - Set the `$winserverCredentials` variable as the `WindowsCredential` parameter value.
   - Set the `$linuxcredential` variable as the `LinuxCredential` parameter value.
   - Provide the `Restart` parameter.

:::

::: example
### Example 5: Reverting Configuration Parameters to Default Values

This example shows how to revert configuration parameters of the Windows-based backup proxy server to default values.

```
$xpath = "/Veeam/Archiver/Server"
$key = "TestKey"
$vboproxy = Get-VBOProxy -Hostname 172.17.53.53
$winserverCredentials = Get-Credential
Set-VBOConfigurationParameter -XPath $xpath -Key $key -Proxy $vboproxy -WindowsCredential $winserverCredentials -RevertToDefault -Restart
```

Perform the following steps:

1. Enter values for the `XPath` and `Key` parameters. Save them to the `$xpath` and `$key` variables.
2. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$vboproxy` variable.
3. 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 `$winserverCredentials` variable.
4. Run the `Set-VBOConfigurationParameter` cmdlet. Specify the following settings:

   - Set the `$xpath` variable as the `XPath` parameter value.
   - Set the `$key` variable as the `Key` parameter value.
   - Set the `$vboproxy` variable as the `Proxy` parameter value.
   - Set the `$winserverCredentials` variable as the `WindowsCredential` parameter value.
   - Provide the `RevertToDefault` parameter.
   - Provide the `Restart` parameter.

:::

::: example
### Example 6: Enabling TLS Encryption on Veeam Backup for Microsoft 365 Controller

These commands enable the TLS encryption for the PostgreSQL instance traffic on the Veeam Backup for Microsoft 365 controller.

```
Set-VBOConfigurationParameter -XPath "/Veeam/Archiver/ControllerPostgres" -Key "TlsEnabled" -Value "True" -Controller
Set-VBOConfigurationParameter -XPath "/Veeam/Archiver/ControllerPostgres" -Key "CertificateThumbprint" -Value "86F1769B6E0544E16A6EA1E9E9BC0BB71A8DE900" -Controller
Set-VBOConfigurationParameter -XPath "/Veeam/Archiver/RemoteProxyDeploymentSettings" -Key "TlsEnabled" -Value "True" -Controller
Set-VBOConfigurationParameter -XPath "/Veeam/Archiver/RemoteProxyDeploymentSettings" -Key "CertificateThumbprint" -Value "86F1769B6E0544E16A6EA1E9E9BC0BB71A8DE900" -Controller
```

:::

## Related Commands

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