This is an archive version of the document. To get the most up-to-date information, see the current version.Remove-VBRViProxy
Short Description
Removes VMware backup proxy from Veeam Backup & Replication.
Applies to
Platform: VMware
For Hyper-V, run Remove-VBRHvProxy.
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Remove-VBRViProxy -Proxy <CViProxy[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
Detailed Description
This cmdlet removes the specified VMware backup proxy from Veeam Backup & Replication.
When you remove a backup proxy, Veeam Backup & Replication unassigns the proxy role from the server, so it is no longer used as a backup proxy. The actual server remains connected to Veeam Backup & Replication.
|
You cannot remove a backup proxy that is explicitly selected in any backup, replication or VM copy job. To remove such a proxy, you need to delete all job references to it first. |
Run Disable-VBRViProxy to disable a VMware proxy.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Proxy | Specifies the array of VMware proxies you want to remove. | True | Named | True (ByValue, | False |
WhatIf | Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action. | False | Named | False | False |
Confirm | Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue. | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
Example 1
This command removes the proxies named "Proxy 01" and "Proxy 03". The proxies are obtained with Get-VBRViProxy and piped down.
Example 2
This command removes the proxy represented by the $proxy variable. The proxy is obtained with Get-VBRViProxy and assigned to the variable beforehand.
Related Commands
