---
title: "New-VBRSureBackupTestScript"
description: "Defines recovery verification scripts for VMs. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet creates the VBRSureBackupTestScript object that defines reco"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrsurebackuptestscript.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Application Groups > New-VBRSureBackupTestScript"
dateModified: "2026-08-19"
---

# New-VBRSureBackupTestScript

## Short Description
Defines recovery verification scripts for VMs.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Custom</code></p>

```
New-VBRSureBackupTestScript -Name <String> -Path <String> -Argument <String> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>PredefinedApplication</code></p>

```
New-VBRSureBackupTestScript -PredefinedApplication <VBRSureBackupApplication> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the `VBRSureBackupTestScript` object that defines recovery verification scripts for VMs that are added to application groups and to jobs that are linked to SureBackup jobs. Veeam Backup & Replication will run this script to verify that the VM that has been assigned the specific role has up and running applications for this role.

## 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">Argument</span></p>
        </td>
        <td>
          <p>Specifies an IP address and the port number. The cmdlet will use this IP address and port to access the VM.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <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 script. The cmdlet will define a script with the specified name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Path</span></p>
        </td>
        <td>
          <p>Specifies a path to a custom script. The cmdlet will use this path to access the script.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PredefinedApplication</span></p>
        </td>
        <td>
          <p>Specifies a script for predefined roles. The cmdlet will run the script to verify applications inside VMs. You can specify the script for either of the following roles:</p><ul><li><code>DNSServer</code></li><li><code>DomainController</code></li><li><code>GlobalCatalog</code></li><li><code>MailServer</code></li><li><code>SQLServer</code></li><li><code>WebServer</code></li><li><code>VBO</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRSureBackupApplication</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 `VBRSureBackupTestScript` object that defines recovery verification scripts for VMs that are added to application groups and to jobs that are linked to SureBackup jobs.

## Examples

::: example
### Example 1. Defining Recovery Verification Script for Custom VM Roles

This command defines the `ScriptVerification` verification script for custom VM roles. The script will be defined with the following settings:

- The script is located at the `C:\scripts\pre-script.bat` path.
- Veeam Backup & Replication will use the `192.0.2.5` IP and the `53` port to access the VM.

```
New-VBRSureBackupTestScript -Name "ScriptVerification" -Path "C:\scripts\script.bat" -Argument "192.0.2.5 53"
```

:::

::: example
### Example 2. Defining Recovery Verification Script for Predefined VM Roles

This command defines a verification script for the `DNS Server` VM role. Veeam Backup & Replication will run the script to verify that the VM with the DNS Server role has up and running applications for this role.

```
New-VBRSureBackupTestScript -PredefinedApplication DNSServer
```

:::