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 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[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Related Commands

Get-VBRJob

Find-VBRHvEntity

Detailed Description

This cmdlet allows to add VM(s) to an existing job.

You can run this cmdlet with any kind of jobs.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Job

Specifies the job(s) you want to add the VM(s) to.

You can assign multiple backup jobs to this object.

True

Named

False

False

Entities

Specifies the VM(s) you want to add to the job.

You can assign multiple VMs to this object.

True

Named

True (ByValue,
ByProperty
Name)

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 1

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

PS C:\PS> Find-VBRHvEntity -Name VM01 | Add-VBRHvJobObject -Job $"Backup Hv Job"

Example 2

This command adds a VM represented by $Vm variable to the job represented to $"Backup Hv Job" variable. The variables are assigned beforehand.

PS C:\PS> Add-VBRHvJobObject -Job $"Backup Hv Job" -Entities $Vm