Rescan-VBREntity

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 objects:

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 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.tech.local tape server.

$tapesrv = Get-VBRTapeServer -Name "srv01.tech.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 $webservices variable.
  2. Run the Rescan-VBREntity cmdlet. Set the $webservices variable as the Entity parameter value.

Related Commands