---
title: "Add-VBRHvBackupJob"
description: "Creates Hyper-V backup jobs. Platform: Hyper-V For VMware, run the Add-VBRViBackupJobCreates VMware backup jobs. cmdlet. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License Creates Hyper-V backup jobs."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrhvbackupjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > Working with Jobs > Add-VBRHvBackupJob"
dateModified: "2026-08-19"
---

# Add-VBRHvBackupJob

## Short Description
Creates Hyper-V backup jobs.

**Platform**: Hyper-V

For VMware, run the [`Add-VBRViBackupJob`](add-vbrvibackupjob.md) cmdlet.

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

## Syntax
```
Add-VBRHvBackupJob [-Name <String>] [-BackupRepository <CBackupRepository>] -Entity <IHvItem[]>
 [-Description <String>] [-Force] [-HighPriority] [-EncryptionKey <PSCryptoKey>] [-KMSServer <VBRKMSServer>] [<CommonParameters>]
```

## Detailed Description
Creates Hyper-V backup jobs.

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

Run the [`Start-VBRJob`](start-vbrjob.md) cmdlet to run the job manually.

Run the [`Set-VBRJobSchedule`](set-vbrjobschedule.md) cmdlet to set schedule for the job.

::: note

The cmdlet will not run if the geographic location of the VMs added to the job and the job target repository location do not match. If you still want to run the cmdlet, use the `Force` parameter.

:::

## 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">BackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the backup repository where the created backup will be stored.</p><p>Default: default backup repository.</p><p>Accepts the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the backup job.</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">EncryptionKey</span></p>
        </td>
        <td>
          <p>Specifies the encryption key that you want to use to encrypt the data.</p><p>Accepts the <code>PSCryptoKey</code> object. To get this object, run the <a href="get-vbrencryptionkey.md"><code>Get-VBREncryptionKey</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="pscryptokey.md"><code>PSCryptoKey</code></a></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">Entity</span></p>
        </td>
        <td>
          <p>Specifies the array of Hyper-V VMs you want to add to the job.</p><p>Accepts the <code>IHvItem[]</code> object. To get this object, run the <a href="find-vbrhventity.md"><code>Find-VBRHvEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IHvItem[]</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create a backup job even if the geographic location of the VMs added to the job and the target backup repository location do not match.</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">HighPriority</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will prioritize this job higher than other similar jobs and will allocate resources to it in the first place.</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">KMSServer</span></p>
        </td>
        <td>
          <p>Specifies KMS servers added to the Veeam Backup & Replication console. The cmdlet will decrypt data encrypted by this server.</p><p>Accepts the <a href="vbrkmsserver.md"><code>VBRKMSServer</code></a> object. To get this object, run the <a href="get-vbrkmsserver.md"><code>Get-VBRKMSServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrkmsserver.md"><code>VBRKMSServer</code></a></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 the name you want to assign to the backup job.</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>
    </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).

## Examples

::: example
### Example 1. Creating Backup Job [Using Pipeline]

This example shows how to create a backup job named `Exchange Backup`.

```
$Repository = Get-VBRBackupRepository -Name "Backup Repository"
Find-VBRHvEntity -Name Exchange* | Add-VBRHvBackupJob -Name "Exchange Backup" -BackupRepository $Repository -Description "Hyper-V Exchange Backup"
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$Repository` variable.
2. Run the [`Find-VBRHvEntity`](find-vbrhventity.md) cmdlet. Specify the `Name` parameter value.
3. Pipe the cmdlet output to the `Add-VBRHvBackupJob` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Specify the `Description` parameter value.
   - Set the `$Repository` variable as the `BackupRepository` parameter value.

:::

::: example
### Example 2. Creating Backup Job [Using Variable]

This example shows how to create a backup job for the VM represented by the `$Vm` variable.

```
$Repository = Get-VBRBackupRepository -Name "Backup Repository"
$Vm = Find-VBRHvEntity -Name "VM01"
Add-VBRHvBackupJob -BackupRepository $Repository -Entity $Vm
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$Repository` variable.
2. Run the [`Find-VBRHvEntity`](find-vbrhventity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$Vm` variable.
3. Run the `Add-VBRHvBackupJob` cmdlet. Set the `$Repository` variable as the `BackupRepository` parameter value. Set the `$Vm` variable as the `Entity` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Find-VBRHvEntity`](find-vbrhventity.md)