Rescan-VBREntity

In this article

    Short Description

    Rescans backup infrastructure components.

    Applies to

    Platform: VMware, Hyper-V

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

    Syntax

    This cmdlet provides parameter sets that allow you to:

    • Rescan a selected component:

    Rescan-VBREntity -Entity <Object[]> [-Wait]  [<CommonParameters>]

    • Rescan all items of a selected type:

    Rescan-VBREntity [-AllReplicas] [-AllHosts] [-AllTapeServers] [-AllRepositories] [-AllCloudProviders] [-Wait] [<CommonParameters>]

    Detailed Description

    This cmdlet rescans backup infrastructure components added to Veeam Backup & Replication:

    • Hosts and clusters
    • Tape servers
    • Tape libraries
    • Backup repositories
    • Cloud providers
    • Veeam backup database for new replica restore points
    • Protection groups
    • Discovered computers
    • Discovered Active Directory objects

    You can rescan components, for example, after configuration restore.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    Entity

    Specifies an array of components you want to rescan.

    Accepts the following types:

    True

    Named

    True (ByValue)

    AllReplicas

    Defines that the cmdlet will rescan all replicas restore points.

    SwitchParameter

    False

    Named

    False

    AllHosts

    Defines that the cmdlet will rescan all managed hosts.

    SwitchParameter

    False

    Named

    False

    AllTapeServers

    Defines that the cmdlet will rescan all tape servers.

    SwitchParameter

    False

    Named

    False

    AllRepositories

    Defines that the cmdlet will rescan all backup repositories.

    SwitchParameter

    False

    Named

    False

    AllCloudProviders

    Defines that the cmdlet will rescan all cloud providers.

    SwitchParameter

    False

    Named

    False

    Wait

    Defines that the command waits for the process to complete before accepting more input.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

    Examples

    Rescan-VBREntityExample 1. Rescanning all Hosts Managed by Veeam Backup & Replication

    This command rescans servers managed by Veeam Backup & Replication.

    Rescan-VBREntity -AllHosts

    Rescan-VBREntityExample 2. Rescanning Backup Repository

    This example shows how to rescan the Win2012Repo backup repository.

    $repository = Get-VBRBackupRepository -Name "Win2012Repo"

    Rescan-VBREntity -Entity $repository

    Perform the following steps:

    1. Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
    2. Run the Rescan-VBREntity cmdlet. Set the $repository variable as the Entity parameter value.

    Rescan-VBREntityExample 3. Rescanning Tape Server

    This example shows how to rescan the srv01.veeam.local tape server.

    $tapesrv = Get-VBRTapeServer -Name "srv01.veeam.local"

    Rescan-VBREntity -Entity $tapesrv -Wait

    Perform the following steps:

    1. Run the Get-VBRTapeServer cmdlet. Specify the Name parameter value. Save the result to the $tapesrv variable.
    2. Run the Rescan-VBREntity cmdlet. Set the $tapesrv variable as the Entity parameter value. Provide the Wait parameter.

    Rescan-VBREntityExample 4. Rescanning Replica Restore Points

    This example shows how to rescan the 'Webservices' replica restore points.

    $webservices = Get-VBRReplica -Name "Webservices"

    Rescan-VBREntity -Entity $webservices

    Perform the following steps:

    1. Run the Get-VBRReplica cmdlet. Specify the Name parameter value. Save the result to the $tapesrv variable.
    2. Run the Rescan-VBREntity cmdlet. Set the $webservices variable as the Entity parameter value.

    Related Commands