Remove-VBOProxy

Short Description

Removes backup proxy servers.

Syntax

Remove-VBOProxy -Proxy <VBOProxy> [-Force] [-Credential <PSCredential>] [-WindowsCredential <PSCredential>] [-LinuxCredential <VBOLinuxCredential>] [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet allows you to remove backup proxy servers from the Veeam Backup for Microsoft 365 infrastructure.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Proxy	Specifies a backup proxy server. The cmdlet will remove this backup proxy server from the Veeam Backup for Microsoft 365 infrastructure.	Accepts the VBOProxy object. To get this object, run the Get-VBOProxy cmdlet.	True	Named	True (ByValue)
Force	Defines that the cmdlet will remove a backup proxy server without showing warnings in the PowerShell console. If you do not provide the parameter, the cmdlet will prompt you to confirm the operation. Default: False	SwitchParameter	False	Named	False
Credential	Specifies Windows credentials. The cmdlet will use these credentials to connect to the Windows-based backup proxy server. If you omit this parameter, the cmdlet will use the Windows credentials under which you are currently logged in. Note: This parameter will be deprecated in future versions of Veeam Backup for Microsoft 365. Use the WindowsCredential parameter instead.	PSCredential	False	Named	False
WindowsCredential	Specifies Windows credentials. The cmdlet will use these credentials to connect to the Windows-based backup proxy server. If you omit this parameter, the cmdlet will use the Windows credentials under which you are currently logged in.	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
WhatIf	Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action. Default: False	SwitchParameter	False	Named	False
Confirm	Defines that the cmdlet will display a prompt that asks if the user is sure that he wants to continue. Default: True	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.

Output Object

None.

Examples

Example 1: Removing Windows-Based Backup Proxy Server from Veeam Backup for Microsoft 365 Infrastructure

This example shows how to remove the tech.support.local backup proxy server from the Veeam Backup for Microsoft 365 infrastructure.

$proxy = Get-VBOProxy -Hostname tech.support.local

Remove-VBOProxy -Proxy $proxy -Force

Perform the following steps:

Run the Get-VBOProxy cmdlet. Specify the Hostname parameter value. Save the result to the $proxy variable.
Run the Remove-VBOProxy cmdlet. Set the $proxy variable as the Proxy parameter value. Provide the Force parameter.

Example 2: Removing Linux-Based Backup Proxy Server from Veeam Backup for Microsoft 365 Infrastructure

This example shows how to remove the linux01 backup proxy server from the Veeam Backup for Microsoft 365 infrastructure.

$linuxpwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force

$linuxcredentials = New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot:$true -Password $linuxpwd

$proxy = Get-VBOProxy -Hostname linux01

Remove-VBOProxy -Proxy $proxy -LinuxCredential $linuxcredentials

Perform the following steps:

Run the ConvertTo-SecureString cmdlet. Specify the necessary parameters. Save the result to the $linuxpwd variable.
Run the New-VBOLinuxCredential cmdlet. Specify the necessary parameters. Save the result to the $linuxcredentials variable.
Run the Get-VBOProxy cmdlet. Specify the Hostname parameter value. Save the result to the $proxy variable.
Run the Remove-VBOProxy cmdlet. Set the $proxy variable as the Proxy parameter value. Set the $linuxcredentials variable as the LinuxCredential parameter value.

Related Commands