This is an archive version of the document. To get the most up-to-date information, see the current version.Remove-VBRServer
Short Description
Removes hosts from Veeam Backup & Replication.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Remove-VBRServer [-Server] <CHost[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
Detailed Description
This cmdlet removes a selected host from Veeam Backup & Replication.
When you remove a host, you only stop managing it via your Veeam Backup & Replication console. The host is not deleted as well as data stored on it, i.e. the backup files. You can import these backup files later to the Veeam Backup & Replication console by running Import-VBRBackup.
Note that when you remove servers from Veeam Backup & Replication, the backups of the removed hosts stay in the Veeam Backup & Replication database and repository.
|
A server that has any dependencies cannot be deleted. For example, you cannot delete a server that is referenced by a backup or replication job, or that performs the role of a backup proxy or repository. To remove such a server, you will need to delete all referencing jobs or roles first. |
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Server | Specifies the array of servers you want to remove. | True | 1 | 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 a Virtual Center named "vCenter01". The server is obtained with Get-VBRServer, selected by the Type and Name parameters, and piped down.
Example 2
This command removes the server represented by the $server variable. The server object is obtained with Get-VBRServer and assigned to the variable beforehand.
Related Commands
