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 a selected server 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>] |
Related Commands
Detailed Description
This cmdlet removes a selected server or host (VMware or Hyper-V) from Veeam Backup & Replication. You can remove the following servers:
- Backup Server: the server where Veeam Backup & Replication is installed.
- ESX: ESX host.
- ESXi: ESXi host.
- HvCluster: Hyper-V cluster.
- HvServer: Hyper-V host.
- Linux: Linux server.
- Local: this server.
- SanHost: storage system server.
- Scvmm: Microsoft System Center Virtual Machine Manager server.
- SmbCluster: Microsoft SMB cluster.
- SmbServer: Microsoft SMB server.
- VC: VMware vCloud server.
- VcdSystem: VMware vCloud Director server.
- Windows: Windows server.
- Cloud: cloud server.
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 your Veeam Backup & Replication managing console, 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 server you want to remove. You can assign multiple servers to this object. | 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 about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.
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.
