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 a VMware backup proxy from the backup infrastructure.
Applies to
Platform: VMware
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
Remove-VBRViProxy -Proxy <CViProxy[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
Detailed Description
This cmdlet removes the specified VMware backup proxy from the backup infrastructure.
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 added to the backup infrastructure.
Note: |
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 the Disable-VBRViProxy cmdlet to disable a VMware backup proxy.
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|---|---|---|---|---|
Proxy | Specifies an array of VMware proxies you want to remove. | Accepts the CViProxy[] object. To get this object, run the Get-VBRViProxy cmdlet. | True | Named | True (ByValue, |
WhatIf | Defines that the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action. | SwitchParameter | False | Named | False |
Confirm | Defines that the cmdlet displays a prompt that asks if the user is sure that they want to continue. | SwitchParameter | False | Named | False |
<CommonParameters>
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 VMware Backup Proxy [Using Variable]
Example 2. Removing VMware Backup Proxy [Using Pipeline]
Related Commands
