---
title: "New-VBRSureBackupLinkedJob"
description: "Defines jobs linked with the SureBackup job. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRSureBackupLinkedJob object that defines jobs linked with the SureBackup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrsurebackuplinkedjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Jobs > New-VBRSureBackupLinkedJob"
dateModified: "2026-08-19"
---

# New-VBRSureBackupLinkedJob

## Short Description
Defines jobs linked with the SureBackup job.

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

## Syntax
```
New-VBRSureBackupLinkedJob -Job <CBackupJob> [-Role <VBRSureBackupRole[]>]
 [-TestScript <VBRSureBackupTestScript[]>] [-StartupOptions <VBRSureBackupStartupOptions>]
 [-Credentials <CCredentials>] [-VM <VBRSureBackupVM[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the `VBRSureBackupLinkedJob` object that defines jobs linked with the SureBackup 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">Credentials</span></p>
        </td>
        <td>
          <p>Specifies credentials. The cmdlet will use these credentials to authenticate against the VM and to run a recovery verification script.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">Job</span></p>
        </td>
        <td>
          <p>Specify a backup or replication job. Veeam Backup & Replication will verify VMs from this job with the SureBackup job.</p><p>Accepts the <code>CBackupJob</code> object. To create this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupJob</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Role</span></p>
        </td>
        <td>
          <p>Specifies a role that VM from the linked job performs. You can specify either of the following roles:</p><ul><li><code>DNSServer</code></li><li><code>GlobalCatalog</code></li><li><code>MailServer</code></li><li><code>SQLServer</code></li><li><code>WebServer</code></li><li><code>DomainControllerAuthoritative</code></li><li><code>DomainControllerNonAuthoritative</code></li><li><code>VBO</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupRole[]</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">StartupOptions</span></p>
        </td>
        <td>
          <p>Specifies startup settings for VMs from the linked job.</p><p>Accepts the <code>VBRSureBackupStartupOptions</code> object. To create this object, run the <a href="new-vbrsurebackupstartupoptions.md"><code>New-VBRSureBackupStartupOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupStartupOptions</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">TestScript</span></p>
        </td>
        <td>
          <p>Specifies recovery verification scripts for VMs from the linked job.</p><p>Accepts the <code>VBRSureBackupTestScript[]</code> object. To create this object, run the <a href="new-vbrsurebackuptestscript.md"><code>New-VBRSureBackupTestScript</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupTestScript[]</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">VM</span></p>
        </td>
        <td>
          <p>Specifies an array of VMs. The cmdlet will run a verification script on these VMs.</p><p>Accepts the <code>VBRSureBackupV[]</code> object. To create this object, run the <a href="new-vbrsurebackupvm.md"><code>New-VBRSureBackupVM</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupVM[]</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>
    </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 `VBRSureBackupLinkedJob` object that defines jobs linked with the SureBackup job.

## Examples

::: example
### Example 1. Defining Linked Job with Verification Script

This example shows how to define a linked job that will be verified with the SureBackup job. Veeam Backup & Replication will run a verification script to verify the VM with the Global Catalog role has up and running applications for this role.

```
$job = Get-VBRJob -Name "Exchange Job"
$script = New-VBRSureBackupTestScript -PredefinedApplication GlobalCatalog
New-VBRSureBackupLinkedJob -Job $job -Role GlobalCatalog -TestScript $script
```

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-VBRSureBackupTestScript`](new-vbrsurebackuptestscript.md) cmdlet. Specify the `GlobalCatalog` option as the `PredefinedApplication` parameter value. Save the result to the `$script` variable.
3. Run the `New-VBRSureBackupLinkedJob` cmdlet. Specify the following settings:

   - Set the `$job` variable as the `Job` parameter value.
   - Specify the `GlobalCatalog` as the `Role` parameter value.
   - Set the `$script` variable as the `TestScript` parameter value.

:::

::: example
### Example 2. Defining Linked Job with Startup Options

This example shows how to define a linked job that will be verified with the SureBackup job. Veeam Backup & Replication will run a verification script to verify the VM with the Global Catalog role has up and running applications for this role.

```
$job = Get-VBRJob -Name "Exchange Job"
$startup = New-VBRSureBackupStartupOptions -MaximumBootTime 200 -ApplicationInitializationTimeout 150 -AllocatedMemory 80 -EnableVMPingCheck -EnableVMHeartbeatCheck
New-VBRSureBackupLinkedJob -Job $job -StartupOptions $startup
```

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-VBRSureBackupStartupOptions`](new-vbrsurebackupstartupoptions.md) cmdlet. Specify the necessary parameters. Save the result to the `$startup` variable.
3. Run the `New-VBRSureBackupLinkedJob` cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$startup` variable as the `StartupOptions` parameter value.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`New-VBRSureBackupStartupOptions`](new-vbrsurebackupstartupoptions.md)
- [`New-VBRSureBackupTestScript`](new-vbrsurebackuptestscript.md)