Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Add-VBRHvJobObject

Short Description

Adds a new object to a Hyper-V job.

Applies to

Platform: Hyper-V

For VMware, run Add-VBRViJobObject.

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Add-VBRHvJobObject -Job <CBackupJob> -Entities <IHvItem[]> [-Force]  [<CommonParameters>]

Detailed Description

This cmdlet allows to add VMs to an existing job.

You can run this cmdlet with any kind of jobs.

Starting from Veeam Backup & Replication version 9.5 Update 3, the cmdlet checks if the data of the VMs added to the job changes its geographical location.

Add-VBRHvJobObject Note:

The cmdlet will not run if the geographical 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

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Job

Specifies the job. The cmdlet will add VMs to this job.

True

Named

False

False

Entities

Specifies the array of Hyper-V VMs you want to add to the job.

True

Named

True (ByValue,
ByProperty
Name)

False

Force

Indicates that the cmdlet will add VMs to the existing job even if the geographical location of these VMs and the target backup repository location do not match.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example

This example shows how to add a VM to the existing job.

  1. Run  Find-VBRHvEntity to get the required VM. Save the result to the $vm variable.
  2. Run Get-VBRJob to get the required job. Save the result to the $hvjob variable.
  3. Run Add-VBRHvJobObject with the $vm and $hvjob variables.

PS C:\PS> $vm = Find-VBRHvEntity -Name "VM01"

PS C:\PS> $hvjob = Get-VBRJob -Name "BackupHvJob01"

PS C:\PS> Add-VBRHvJobObject -Entities $vm -Job $hvjob

Related Commands

Get-VBRJob

Find-VBRHvEntity

Get-VBRLocation

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation