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

Start-VBRJob

Short Description

Starts existing jobs.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Start-VBRJob [-Job] <CBackupJob[]> [-FullBackup] [-RetryBackup] [-StartChainedJobs] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet allows you to start a created or stopped job. You can start the following types of jobs:

  • Backup jobs
  • Replication jobs
  • Copy jobs

Start-VBRJob Note:

Run Start-VSBJob to start a SureBackup job.

This cmdlet allows you to perform the following actions with the jobs:

  • Start a job for an ordinary run
  • Force a full backup
  • Set the job to restart in case it failed

When you create a job, you need to run it manually unless you enable a job schedule. Run Set-VBRJobSchedule to schedule the job to run automatically.

Run Stop-VBRJob to stop a running job.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Job

Specifies the array of jobs you want to start.

True

1

True (ByValue,
ByProperty
Name)

False

FullBackup

Indicates that the job will create an active full backup.

False

Named

False

False

RetryBackup

Indicates that the job will restart the job if it fails.

False

Named

False

False

StartChainedJobs

Indicates that the job will start the jobs that are scheduled to run after this job.

False

Named

False

False

RunAsync

Indicates that the command returns immediately without waiting for the task to complete.

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 1

This example shows how to start a job.

You will need to perform the following steps:

  1. Run Get-VBRJob to get the job. Save the result to the $copyjob variable.
  2. Run Start-VBRJob with the $copyjob variable.

PS C:\PS> $copyjob = Get-VBRJob -Name "WebApplications Server Backup"

PS C:\PS> Start-VBRJob -Job $copyjob

Example 2

This example shows how to start a vCloud backup job right after the job is created.

You will need to perform the following steps:

  1. Run Find-VBRvCloudEntity to get the list of vCloud Director entities. Save the result to the $cloudserver variable.
  2. Run Add-VBRvCloudJob to create a vCloud backup job with the $cloudserver variable. Save the result to the $cloudjob variable.
  3. Run Start-VBRJob with the $cloudjob variables. Use the RunAsync parameter to run the process on the background.

PS C:\PS> $cloudserver = Find-VBRvCloudEntity -Name "vCloudServer"

PS C:\PS> $cloudjob = Add-VBRvCloudJob -Entity $vCloudServer -Name "vCloudServerBackup"

PS C:\PS> Start-VBRJob -Job $cloudjob -RunAsync

Example 3

This example shows how to start a job.

You will need to perform the following steps:

  1. Run Get-VBRJob to get the job. Save the result to the $backupjob variable.
  2. Run Start-VBRJob with the $backupjob variable. Use the FullBackup parameter to create an active full backup.

PS C:\PS> $backupjob = Get-VBRJob -Name "WebApplications Server Backup"

PS C:\PS> Start-VBRJob -Job $backupjob -FullBackup

Example 4

This example shows how to restart a failed job.The process runs on the background and the command returns immediately without waiting for the task to complete.

You will need to perform the following steps:

  1. Run Get-VBRJob to get the failed job. Save the result to the $job variable.
  2. Run Start-VBRJob with the $job variable. Use RunAsync to run the process on the background.

PS C:\PS> $job = Get-VBRJob -Name "My Backup"

PS C:\PS> Start-VBRJob -Job $job -RetryBackup -RunAsync

Related Commands

Get-VBRJob

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

Backup and Restore of SQL Server Databases

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide