Set-VBOConfigurationParameter - Veeam Backup for Microsoft 365 PowerShell Reference

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

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. Note: If the ProxyPool parameter is used, you must specify Windows credentials to connect to all Windows-based backup proxy servers in the backup proxy pool.	PSCredential	False	Named	False
LinuxCredential	Specifies Linux credentials. The cmdlet will use these credentials to connect to the Linux-based backup proxy server. Note: If the ProxyPool parameter is used, you must specify Linux credentials to connect to all Linux-based backup proxy servers in the backup proxy pool.	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 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.

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.

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:

Enter values for the XPath, Key and Value parameters. Save them to the $xpath, $key and $value variables.
Run the Get-VBOProxyPool cmdlet. Specify the Name parameter value. Save the result to the $vboproxypool variable.
Run the Get-Credential cmdlet. Enter the credentials you want to use to connect to the backup proxy server. Save the result to the $winserverCredentials 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 $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.