This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRNASBackupHealthCheck

Short Description

Performs a health check for the latest restore point in the backup chain and its repair if necessary.

Applies to

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

Syntax

Start-VBRNASBackupHealthCheck -Job <CBackupJob[]> [-Repair] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet performs a health check for the latest restore point in the backup chain and its repair if necessary. During the health check, Veeam Backup & Replication performs a CRC check for metadata and a hash check for data blocks in backup files to verify their integrity. If the health check returns notifications of some inconsistencies, you can run the backup repair. That requires running the cmdlet again with the Repair option enabled.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Job	Specifies a file backup job. The cmdlet will perform a health check for this backup job.	Accepts the CBackupJob[] object. To get this object, run the Get-VBRNASBackupJob cmdlet.	True	Named	True (ByValue, ByPropertyName)
Repair	Defines that the cmdlet will repair missing data and metadata. If you provide this parameter, the cmdlet will repair the missing metadata. Otherwise, the cmdlet will perform a health check of backup files and if corruption is detected, it will return a notification. Note: First, run the cmdlet with this option disabled to perform the health check. After that, if there are any inconsistencies in the backup, run the cmdlet again with this option enabled.	SwitchParameter	False	Named	False
RunAsync	Indicates that the command returns immediately without waiting for the task to complete.	SwitchParameter	False	Named	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Job

Specifies a file backup job. The cmdlet will perform a health check for this backup job.

Accepts the CBackupJob[] object. To get this object, run the Get-VBRNASBackupJob cmdlet.

True

Named

True (ByValue, ByPropertyName)

Repair

Defines that the cmdlet will repair missing data and metadata.

If you provide this parameter, the cmdlet will repair the missing metadata. Otherwise, the cmdlet will perform a health check of backup files and if corruption is detected, it will return a notification.

Note: First, run the cmdlet with this option disabled to perform the health check. After that, if there are any inconsistencies in the backup, run the cmdlet again with this option enabled.

SwitchParameter

False

Named

False

RunAsync

Indicates that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

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

Output Object

The cmdlet returns the VBRNASBackupHealthCheck object that contains results of a health check for file backup jobs.

Examples

Start-VBRNASBackupHealthCheck Example 1. Performing Health Check

Start-VBRNASBackupHealthCheck Example 2. Performing Backup Repair

Related Commands

Get-VBRNASBackupJob