---
title: "Add-VBRSureBackupContentScanJob"
description: "Creates a backup content scan SureBackup job. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates a SureBackup job that runs in the backup content scan verification mode."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrsurebackupcontentscanjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Jobs > Add-VBRSureBackupContentScanJob"
dateModified: "2026-08-19"
---

# 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`](start-vbrsurebackupjob.md) cmdlet to run the job manually.

Run the [`New-VBRSureBackupJobScheduleOptions`](new-vbrsurebackupjobscheduleoptions.md) to set schedule for the job.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies a description for a SureBackup job. The cmdlet will create a SureBackup job with this description.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will not show any warnings.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LinkedJob</span></p>
        </td>
        <td>
          <p>Specifies a backup or replication job. The cmdlet will verify VMs that are added to this job with the lite SureBackup job.</p><p>Accepts the <code>VBRSureBackupLinkedJob[]</code> object. To create this object, run the <a href="new-vbrsurebackuplinkedjob.md"><code>New-VBRSureBackupLinkedJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupLinkedJob[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">MaxConcurrentVMs</span></p>
        </td>
        <td>
          <p>Specifies the maximum number of VMs that can be started at the same time.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies a name for a SureBackup job. The cmdlet will create a SureBackup job with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ProcessRandomMachines</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will randomly test the specified number of machines from the linked job.</p><p>Use the <code>RandomMachinesMaxCount</code> parameter to specify the number of machines to randomly test.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RandomMachinesMaxCount</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ScheduleOptions</span></p>
        </td>
        <td>
          <p>Specifies schedule settings of a SureBackup job. Veeam Backup & Replication will run the job according to these settings.</p><p>Accepts the <code>VBRSureBackupJobScheduleOptions</code> object. To create this object, run the <a href="new-vbrsurebackupjobscheduleoptions.md"><code>New-VBRSureBackupJobScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupJobScheduleOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UnstructuredLinkedJob</span></p>
        </td>
        <td>
          <p>Specifies an unstructured data backup job. The cmdlet will verify backups created by this job with the lite SureBackup job.</p><p>Accepts the <code>VBRUnstructuredBackupJob[]</code> object. To get this object, run the <a href="get-vbrunstructuredbackupjob.md"><code>Get-VBRUnstructuredBackupJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupJob[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">VerificationOptions</span></p>
        </td>
        <td>
          <p>Specifies verification settings for a SureBackup job.</p><p>Accepts the <code>VBRSureBackupJobVerificationOptions</code> object. To create this object, run the <a href="new-vbrsurebackupjobverificationoptions.md"><code>New-VBRSureBackupJobVerificationOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupJobVerificationOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the `VBRSureBackupContentScanJob` object that defines settings of lite SureBackup jobs.

## Examples

::: example
### 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:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`New-VBRSureBackupLinkedJob`](new-vbrsurebackuplinkedjob.md) cmdlet. Set the `$job` variable as the `Job` parameter value. Save the result to the `$linkedjob` variable.
3. Run the [`New-VBRSureBackupJobVerificationOptions`](new-vbrsurebackupjobverificationoptions.md) cmdlet. Provide the `EnableMalwareScan`, the `EnableEntireImageScan` and the `EnableYARAScan` parameters. Specify the `YARAScanRule` parameter value. Save the result to the `$verification` variable.
4. 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.

:::

::: example
### 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:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`New-VBRSureBackupLinkedJob`](new-vbrsurebackuplinkedjob.md) cmdlet. Set the `$job` variable as the `Job` parameter value. Save the result to the `$linkedjob` variable.
3. Run the [`New-VBRSureBackupJobVerificationOptions`](new-vbrsurebackupjobverificationoptions.md) cmdlet. Provide the `EnableMalwareScan`, the `EnableEntireImageScan` and the `EnableYARAScan` parameters. Specify the `YARAScanRule` parameter value. Save the result to the `$verification` variable.
4. Run the [`New-VBRDailyOptions`](new-vbrdailyoptions.md) cmdlet. Specify the `DayOfWeek` parameter and the `Period` parameter values. Save the result to the `$daily` variable.
5. Run the [`New-VBRSureBackupJobScheduleOptions`](new-vbrsurebackupjobscheduleoptions.md) cmdlet. Specify the `Type` parameter value. Set the `$daily` variable as the `DailyOptions` parameter value. Save the result to the `$schedule` variable.
6. 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.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`New-VBRSureBackupLinkedJob`](new-vbrsurebackuplinkedjob.md)
- [`New-VBRSureBackupJobVerificationOptions`](new-vbrsurebackupjobverificationoptions.md)
- [`New-VBRDailyOptions`](new-vbrdailyoptions.md)
- [`New-VBRSureBackupJobScheduleOptions`](new-vbrsurebackupjobscheduleoptions.md)