Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Rescan-VBREntity

Short Description

Rescans backup infrastructure components.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides two parameter sets.

  • For rescanning a selected component:

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

  • For selecting 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

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

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Entity

Specifies the array of component you want to rescan.

Accepts the following types:

True

Named

True (ByValue)

False

AllReplicas

Indicates that the cmdlet will rescan all replicas restore points.

False

Named

False

False

AllHosts

Indicates that the cmdlet will rescan all managed hosts.

False

Named

False

False

AllTape
Servers

Indicates that the cmdlet will rescan all tape servers.

False

Named

False

False

All
Repositories

Indicates that the cmdlet will rescan all backup repositories.

False

Named

False

False

AllCloud
Providers

Indicates that the cmdlet will rescan all cloud providers.

False

Named

False

False

Wait

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

False

Named

False

False

<CommonParameters>

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 rescans servers managed by your Veeam console.

PS C:\PS> Rescan-VBREntity -AllHosts

Example 2

This command rescans a backup repository named "Win2012Repo". The repository is obtained with Get-VBRBackupRepository and piped down.

PS C:\PS> Get-VBRBackupRepository - Name "Win2012Repo" | Rescan-VBREntity

Example 3

This command rescans the tape server named "srv01.veeam.local". The tape server is obtained with Get-VBRTapeServer and assigned to the 'tapesrv' variable. The Wait parameter is used to prevent the console from taking input until the rescanning ends.

PS C:\PS> $tapesrv = Get-VBRTapeServer -Name "srv01.veeam.local"

PS C:\PS> Rescan-VBREntity -Entity $tapesrv -Wait

Example 4

This command updates information about the 'Webservices' replica restore points. The replica is obtained with Get-VBRReplica and assigned to the '$webservices' variable.

PS C:\PS> $webservices = Get-VBRReplica -Name "Webservices Replica"

PS C:\PS> Rescan-VBREntity -Entity $webservices

Related Commands

Get-VBRServer

Get-VBRTapeServer

Get-VBRTapeLibrary

Get-VBRBackupRepository

Get-VBRCloudProvider

Get-VBRReplica

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation