Remove-VBRServer

Short Description

Removes hosts from the backup infrastructure.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Remove-VBRServer [-Server] <CHost[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet removes a host from the backup infrastructure.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Server	Specifies the array of servers you want to remove.	Accepts the CHost[] object. To get this object, run the Get-VBRServer cmdlet.	True	0	True (ByValue, ByProperty Name)
WhatIf	Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.	SwitchParameter	False	Named	False
Confirm	Defines that the cmdlet will display a prompt that asks if you want to continue running the command.	SwitchParameter	False	Named	False

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

Remove-VBRServer Example 1. Removing Hyper-V Cluster from Backup Infrastructure

This example shows how to remove the Production05 Hyper-V cluster from the backup infrastructure.

$server = Get-VBRServer -Type "HvCluster" -Name "Production05"

Remove-VBRServer -Server $server

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Type and the Name parameter values. Save the result to the $server variable.
Run the Remove-VBRServer cmdlet. Set the $server variable as the Server parameter value.

Remove-VBRServer Example 2. Removing Virtual Center from Backup Infrastructure

This example shows how to remove the vCenter01 Virtual Center from the backup infrastructure.

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

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Type and the Name parameter values.
Pipe the cmdlet output to the Remove-VBRServer cmdlet.

Related Commands

Get-VBRServer