Add-VBRSureBackupContentScanJob

Short Description

Creates a backup content scan SureBackup job.

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

Syntax

Add-VBRSureBackupContentScanJob [-Name <String>] [-Description <String>]

[-LinkedJob <VBRSureBackupLinkedJob[]>] [-UnstructuredLinkedJob <VBRUnstructuredBackupJob[]>]

[-MaxConcurrentVMs <Int32>] [-ProcessRandomMachines]

-VerificationOptions <VBRSureBackupJobVerificationOptions>

[-ScheduleOptions <VBRSureBackupJobScheduleOptions>] [-Force] [-RandomMachinesMaxCount <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet creates a SureBackup job that runs in the backup content scan verification mode. This SureBackup job performs only backup integrity check and its content analysis to detect traces of malware or any other unwanted or sensitive data. These tests do no require setting up a virtual lab or an application group.

Note that when you create a backup job, you need to run it manually unless you enable a job schedule.

Run the Start-VBRSureBackupJob cmdlet to run the job manually.

Run the New-VBRSureBackupJobScheduleOptions to set schedule for the job.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Description	Specifies a description for a SureBackup job. The cmdlet will create a SureBackup job with this description.	`String`	False	Named	False
Force	Defines that the cmdlet will not show any warnings.	`SwitchParameter`	False	Named	False
LinkedJob	Specifies a backup or replication job. The cmdlet will verify VMs that are added to this job with the lite SureBackup job. Accepts the `VBRSureBackupLinkedJob[]` object. To create this object, run the `New-VBRSureBackupLinkedJob` cmdlet.	`VBRSureBackupLinkedJob[]`	False	Named	False
MaxConcurrentVMs	Specifies the maximum number of VMs that can be started at the same time.	`Int32`	False	Named	False
Name	Specifies a name for a SureBackup job. The cmdlet will create a SureBackup job with this name.	`String`	False	Named	False
ProcessRandomMachines	Defines that the cmdlet will randomly test the specified number of machines from the linked job. Use the `RandomMachinesMaxCount` parameter to specify the number of machines to randomly test.	`SwitchParameter`	False	Named	False
RandomMachinesMaxCount	Specifies the number of machines to randomly test during each run. The cmdlet will randomly test the specified number of machines from the linked job.	`Int32`	False	Named	False
ScheduleOptions	Specifies schedule settings of a SureBackup job. Veeam Backup & Replication will run the job according to these settings. Accepts the `VBRSureBackupJobScheduleOptions` object. To create this object, run the `New-VBRSureBackupJobScheduleOptions` cmdlet.	`VBRSureBackupJobScheduleOptions`	False	Named	False
UnstructuredLinkedJob	Specifies an unstructured data backup job. The cmdlet will verify backups created by this job with the lite SureBackup job. Accepts the `VBRUnstructuredBackupJob[]` object. To get this object, run the `Get-VBRUnstructuredBackupJob` cmdlet.	`VBRUnstructuredBackupJob[]`	False	Named	False
VerificationOptions	Specifies verification settings for a SureBackup job. Accepts the `VBRSureBackupJobVerificationOptions` object. To create this object, run the `New-VBRSureBackupJobVerificationOptions` cmdlet.	`VBRSureBackupJobVerificationOptions`	True	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRSureBackupContentScanJob object that defines settings of lite SureBackup jobs.

Examples

Add-VBRSureBackupContentScanJob Example 1. Adding Backup Content Scan SureBackup Job

This example shows how to create a backup content scan SureBackup job which will randomly scan 5 machines from the linked job named Exchange Job. Veeam Backup & Replication will scan these machines with antivirus software and the YARA rule.

$job = Get-VBRJob -Name "Exchange Job"

$linkedjob = New-VBRSureBackupLinkedJob -Job $job

$verification = New-VBRSureBackupJobVerificationOptions -EnableMalwareScan -EnableEntireImageScan -EnableYARAScan -YARAScanRule "Rule.yara"

Add-VBRSureBackupContentScanJob -LinkedJob $linkedjob -Name "Lite Verification Job" -VerificationOptions $verification -ProcessRandomMachines -RandomMachinesMaxCount "5" -Description "SureBackup Job for DNS"

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the New-VBRSureBackupLinkedJob cmdlet. Set the $job variable as the Job parameter value. Save the result to the $linkedjob variable.
Run the New-VBRSureBackupJobVerificationOptions cmdlet. Provide the EnableMalwareScan, the EnableEntireImageScan and the EnableYARAScan parameters. Specify the YARAScanRule parameter value. Save the result to the $verification variable.
Run the Add-VBRSureBackupContentScanJob cmdlet. Specify the following settings:
- Set the $linkedjob variable as the LinkedJob parameter value.
- Specify the Name parameter value.
- Set the $verification variable as the VerificationOptions parameter value.
- Provide the ProcessRandomMachines parameter.
- Specify the RandomMachinesMaxCount parameter value.
- Specify the Description parameter value.

Add-VBRSureBackupContentScanJob Example 2. Adding Backup Content Scan SureBackup Job with Schedule Settings

This example shows how to create a scheduled lite SureBackup job.

$job = Get-VBRJob -Name "Exchange Job"

$linkedjob = New-VBRSureBackupLinkedJob -Job $job

$verification = New-VBRSureBackupJobVerificationOptions -EnableMalwareScan -EnableEntireImageScan -EnableYARAScan -YARAScanRule "Rule.yara"

$daily = New-VBRDailyOptions -DayOfWeek "Friday" -Period "23:00"

$schedule = New-VBRSureBackupJobScheduleOptions -Type "Daily" -DailyOptions $daily

Add-VBRSureBackupContentScanJob -LinkedJob $linkedjob -VerificationOptions $verification -Name "Lite Verification Job" -ScheduleOptions $schedule -Description "SureBackup Job for DNS"

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the New-VBRSureBackupLinkedJob cmdlet. Set the $job variable as the Job parameter value. Save the result to the $linkedjob variable.
Run the New-VBRSureBackupJobVerificationOptions cmdlet. Provide the EnableMalwareScan, the EnableEntireImageScan and the EnableYARAScan parameters. Specify the YARAScanRule parameter value. Save the result to the $verification variable.
Run the New-VBRDailyOptions cmdlet. Specify the DayOfWeek parameter and the Period parameter values. Save the result to the $daily variable.
Run the New-VBRSureBackupJobScheduleOptions cmdlet. Specify the Type parameter value. Set the $daily variable as the DailyOptions parameter value. Save the result to the $schedule variable.
Run the Add-VBRSureBackupContentScanJob cmdlet. Specify the following settings:
- Set the $linkedjob variable as the LinkedJob parameter value.
- Set the $verification variable as the VerificationOptions parameter value.
- Specify the Name parameter value.
- Set the $schedule variable as the ScheduleOptions parameter value.
- Specify the Description parameter value.