This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBRHvJobObject

Short Description

Adds VMs to Hyper-V jobs.

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 adds VMs to Hyper-V jobs.

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 VM(s) to this job.

True

Named

False

False

Entities

Specifies the array of VMware 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 on common parameters, see the About CommonParameters section of Microsoft Docs.

Example 1

This command adds a VM named "VM01" to the job represented by $job variable. First the job object is got and assigned to $BackupHvJob variable. The VM object is obtained with Find-VBRHvEntity and piped down.

Find-VBRHvEntity -Name VM01 | Add-VBRHvJobObject -Job $BackupHvJob

Example 2

This command adds a VM represented by $Vm variable to the job represented to $BackupHvJob variable. The variables are assigned beforehand.

Add-VBRHvJobObject -Job $BackupHvJob -Entities $Vm

Related Commands

Get-VBRJob

Find-VBRHvEntity

Get-VBRLocation