---
title: "Add-VBRViJobObject"
description: "Adds VMs to VMware jobs. Platform: VMware For Hyper-V, run the Add-VBRHvJobObjectAdds VMs to Hyper-V jobs. cmdlet. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet adds VMs to an existing job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrvijobobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > VMs in Job > Add-VBRViJobObject"
dateModified: "2026-08-19"
---

# Add-VBRViJobObject

## Short Description
Adds VMs to VMware jobs.

**Platform**: VMware

For Hyper-V, run the [`Add-VBRHvJobObject`](add-vbrhvjobobject.md) cmdlet.

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

## Syntax
```
Add-VBRViJobObject -Job <CBackupJob> -Entities <IViItem[]> [-Force] [-Multitag] [<CommonParameters>]
```

## Detailed Description
This cmdlet adds VMs to an existing job.

You can run this cmdlet with any kind of jobs.

::: 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">Entities</span></p>
        </td>
        <td>
          <p>Specifies the array of VMware VMs you want to add to the job.</p><p>Accepts the <code>IViItem[]</code> object. To create this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IViItem[]</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 add VMs to the existing job even if the geographic location of these VMs 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">Job</span></p>
        </td>
        <td>
          <p>Specifies the job. The cmdlet will add VMs to this 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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Multitag</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add tags to an existing job.</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>
    </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. Adding VM to Job Represented by Variable [Using Pipeline]

This example shows how to add a VM named `VM01` to the job represented by the `$job` variable.

```
$job = Get-VBRJob -Name "Backup Job"
Find-VBRViEntity -Name VM01 | Add-VBRViJobObject -Job $job
```

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 [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value.
3. Pipe the cmdlet output to the `Add-VBRViJobObject` cmdlet. Set the `$job` variable as the `Job` parameter value.

:::

::: example
### Example 2. Adding VM to Specific Job [Using Variables]

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

```
$job = Get-VBRJob -Name "Backup Job"
$Vm = Find-VBRViEntity -Name "VM01"
Add-VBRViJobObject -Job $job -Entities $Vm
```

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 [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$Vm` variable.
3. Run the `Add-VBRViJobObject` cmdlet. Set the `$job` variable as the `Job` parameter value. Set `$Vm` variable as the `Entities` parameter value.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`Find-VBRViEntity`](find-vbrvientity.md)