Remove-VBRServer

In this article

    Short Description

    Removes hosts from Veeam Backup & Replication.

    Applies to

    Platform: VMware, Hyper-V

    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 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.

    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 array of servers you want to remove.

    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

    <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.

    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

    Related Commands

    Get-VBRServer

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.