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 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.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
WindowsCredential	Specifies Windows credentials. The cmdlet will use these credentials to connect to the Windows-based backup proxy server.	PSCredential	False	Named	False
LinuxCredential	Specifies Linux credentials. The cmdlet will use these credentials to connect to the Linux-based backup proxy server.	Accepts the VBOLinuxCredential object. To get this object, run the New-VBOLinuxCredential cmdlet.	False	Named	False
Proxy	Specifies a backup proxy server. The cmdlet will configure parameters of this backup proxy server.	Accepts the VBOProxy object. To get this object, run the Get-VBOProxy cmdlet.	False	Named	False
ProxyPool	Specifies a backup proxy pool. The cmdlet will configure parameters of all backup proxy servers added to this backup proxy pool.	Accepts the VBOProxyPool object. To get this object, run the Get-VBOProxyPool cmdlet.	False	Named	False
XPath	Specifies the xpath path in the Config.xml file.	String	True	Named	False
Key	Specifies a name of the parameter attribute.	String	True	Named	False
Value	Specifies the parameter attribute value.	String	False	Named	False
RevertToDefault	Defines that the cmdlet will revert the configuration parameters to the default values. Default: False	SwitchParameter	False	Named	False
Restart	Defines that backup proxy servers will be restarted to apply changes in configuration parameters. Default: False	SwitchParameter	False	Named	False
Controller	Defines that the cmdlet will configure parameters of the Veeam Backup for Microsoft 365 controller. Default: False	SwitchParameter	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Examples

Set-VBOConfigurationParameter 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:

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

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

Set-VBOConfigurationParameter 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:

Enter values for the XPath, Key and Value parameters. Save them to the $xpath, $key and $value variables.
Run the Get-VBOProxy cmdlet. Specify the Hostname parameter value. Save the result to the $vboproxy variable.
Run the ConvertTo-SecureString cmdlet. Specify the necessary parameters. Save the result to the $pwd variable.
Run the New-VBOLinuxCredential cmdlet. Specify the necessary parameters. Save the result to the $linuxcredential variable.
Run the Set-VBOConfigurationParameter cmdlet. Specify the following settings:

Set the $xpath variable as the XPath papameter 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.

Related Commands