This is an archive version of the document. To get the most up-to-date information, see the current version.

Remove-VBRServer

In this article

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

Get-VBRServer

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.

Remove-VBRServer Note:

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 Pipeline Input	Accept Wildcard Characters
Server	Specifies the server you want to remove. You can assign multiple servers to this object.	True	1	True (ByValue, ByProperty Name)	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

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.

Get-VBRServer -Type VC -Name vCenter01 | Remove-VBRServer

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.

Remove-VBRServer -Server $server