How to Apply Custom Settings in Veeam Backup for Microsoft 365 Using Set-VBOConfigurationParameter
| KB ID: | 4888 |
| Product: | Veeam Backup for Microsoft 365 | 8 | 8.1 | 8.2 | 8.3 | 8.4 | 8.5 | 8.6 |
| Published: | 2026-08-07 |
| Last Modified: | 2026-08-10 |
Purpose
Solution
How the Scripts in This Article Are Used
Every script in this article begins with the same three variables, which together identify the setting being changed and the value assigned to it:
$xpath = "<XML/Path>" # location of the setting within the configuration file $key = "<SettingName>" # name of the setting $value = "<SettingValue>" # value assigned to the setting
When a custom setting is supplied as a block of these three variables, those values replace the placeholder values at the top of the example scripts provided in this article.
Starting a Veeam Backup for Microsoft 365 PowerShell Session
All commands in this article are run from the Veeam Backup for Microsoft 365 server (controller), including the commands that configure remote backup proxies.
- Open the Veeam Backup for Microsoft 365 console.
- In the main menu ( ☰ ), expand Console and select PowerShell.
Note: Launching PowerShell from outside the Veeam Backup for Microsoft 365 console may require manual loading of the PowerShell modules.
More Information
Custom settings for Veeam Backup for Microsoft 365 are stored in XML configuration files: Config.xml on the controller, Proxy.xml on Windows-based backup proxies, and Proxy.ini on Linux-based backup proxies. Applying a custom setting previously required that each of those files be edited by hand in a text editor on every machine.
The Set-VBOConfigurationParameter cmdlet was introduced to eliminate the need for manual changes to configuration files. The cmdlet writes the value to the correct location in the file, which removes the risk of a typing or formatting error invalidating the file, and applies settings to remote backup proxies without requiring the user to connect directly to those machines.
- Veeam Backup for Microsoft 365 PowerShell Reference > Managing Veeam Backup for Microsoft 365 > Set-VBOConfigurationParameter
- Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > Get-VBOProxy
- Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > New-VBOLinuxCredential
- Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Pools > Get-VBOProxyPool
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.