Rescan-VBREntity

Short Description

Rescans backup infrastructure components.

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides the following parameter sets:

Entity

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

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
Note

You cannot rescan a protection group for pre-installed Veeam Agents. To learn more, see the Protection Group Types section in the Veeam Agent Management Guide.
Discovered computers
Note

You cannot rescan a computer added to a protection group for pre-installed Veeam Agents. To learn more, see the Protection Group Types section in the Veeam Agent Management Guide.
Discovered Active Directory objects

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

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
AllCloudProviders	Defines that the cmdlet will rescan all cloud providers. Default: `False`.	`SwitchParameter`	False	Named	False
AllHosts	Defines that the cmdlet will rescan all managed hosts. Default: `False`.	`SwitchParameter`	False	Named	False
AllReplicas	Defines that the cmdlet will rescan all replicas restore points. Default: `False`.	`SwitchParameter`	False	Named	False
AllRepositories	Defines that the cmdlet will rescan all backup repositories. Default: `False`.	`SwitchParameter`	False	Named	False
AllTapeServers	Defines that the cmdlet will rescan all tape servers. Default: `False`.	`SwitchParameter`	False	Named	False
Entity	Specifies an array of components you want to rescan. Accepts the following objects: `CHost` (hosts connected to the backup infrastructure). Run the `Get-VBRServer` cmdlet to get this object. `VBRTapeServer` (tape servers). Run the `Get-VBRTapeServer` cmdlet to get this object. `VBRTapeLibrary` (tape libraries). Run the `Get-VBRTapeLibrary` cmdlet to get this object. `CBackupRepository` (backup repositories). Run the `Get-VBRBackupRepository` cmdlet to get this object. `VBRCloudProvider` (cloud providers). Run the `Get-VBRCloudProvider` cmdlet to get this object. `CBackup` (only replicas restore points). Run the `Get-VBRReplica` cmdlet to get this object. `VBRProtectionGroup` (protection groups). Run the `Get-VBRProtectionGroup` cmdlet to get this object. `VBRDiscoveredComputer` (discovered computers). Run the `Get-VBRDiscoveredComputer` cmdlet to get this object. `VBRDiscoveredADEntity` (discovered Active Directory objects that belong to the same protection group).Run the `Get-VBRDiscoveredComputer` cmdlet to get this object.	`Object[]`	True	Named	True (ByValue)
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.

Examples

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

This command rescans servers managed by Veeam Backup & Replication.

Rescan-VBREntity -AllHosts

Rescan-VBREntity Example 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:

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

Rescan-VBREntity Example 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:

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

Rescan-VBREntity Example 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:

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