Stop-VBRJob

Short Description

Stops a running backup, replication or copy job.

Platform: VMware, Hyper-V

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

Syntax

Stop-VBRJob [-Job] <CBackupJob[]> [-RunAsync] [-Gracefully] [-WhatIf]

[-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet stops a running backup, replication or tape job. The job is stopped once, the scheduled job will start the next scheduled time.

Run the Start-VBRJobStarts a backup or replication job. cmdlet to start the job manually.

Run the Disable-VBRJobPuts a selected job on hold. cmdlet to temporarily disable a job.

Run the Stop-VSBJobStops running SureBackup job. This cmdlet is obsolete. Run the Stop-VBRSureBackupJob cmdlet instead. cmdlet to stop a SureBackup job.

Run the Stop-VBRComputerBackupJobStops Veeam Agent backup jobs and Veeam Agent backup policies. cmdlet to stop Veeam Agent backup jobs and Veeam Agent backup policies.

Run the Stop-VBRBackupCopyJobStops backup copy jobs. cmdlet to stop a backup copy job.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Gracefully

Defines that the cmdlet will stop a job gracefully.

SwitchParameter

False

Named

False

Job

Specifies the array of jobs you want to stop.

Accepts the CBackupJob object. To get this object, run the Get-VBRJobReturns existing jobs. or Get-VBRTapeJobReturns tape jobs. cmdlet.

CBackupJob[]

True

0

True (ByPropertyName, ByValue)

RunAsync

Defines that the command will return immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

Confirm

Defines that the cmdlet will display a prompt that asks if the user is sure that they want to continue.

Note: Microsoft PowerShell enables the Confirm parameter for this cmdlet by default. To disable this option, set the parameter value to $false. That is, Confirm:$false.

SwitchParameter

False

Named

False

WhatIf

Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.

SwitchParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Stop-VBRJobExample 1. Stopping Specific Job [Using Pipeline]

This example shows how to stop the SharePoint File Copy Job copy job.

Get-VBRJob -Name "SharePoint File Copy Job" | Stop-VBRJob

Perform the following steps:

  1. Run the Get-VBRJobReturns existing jobs. cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Stop-VBRJob cmdlet.

Stop-VBRJobExample 2. Stopping Specific Job [Using Variable]

This example shows how to stop the copy job represented by the $SharePointFileCopyJob variable.

$SharePointFileCopyJob = Get-VBRJob -Name "SharePoint File Copy Job"

Stop-VBRJob -Job $SharePointFileCopyJob

Perform the following steps:

  1. Run the Get-VBRJobReturns existing jobs. cmdlet. Specify the Name parameter value. Save the result to the $SharePointFileCopyJob variable.
  2. Run the Stop-VBRJob cmdlet. Set the $SharePointFileCopyJob variable as the Job parameter value.

Get-VBRJobReturns existing jobs.

Page updated 2026-08-19

Page content applies to build 13.1.1.18