Get-VEMDBRestoreJob

Short Description

Returns active MongoDB restore jobs.

Applies to

Veeam Backup & Replication

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

Return an active restore job using the job ID.

Get-VEMDBRestoreJob -JobId <Guid>[<CommonParameters>]

Return an active restore job using the name of the restored collection.

Get-VEMDBRestoreJob [-CollectionName <String[]>][<CommonParameters>]

Detailed Description

This cmdlet returns an array of ongoing MongoDB restore jobs. After you specify the restore job you need, you can stop the restore process with the Stop-VEMDBRestoreJob cmdlet.

Note the difference between a restore session and a restore job. A restore session is a preliminary step where Veeam Explorer for MongoDB has retrieved the backup from the backup repository, pending restore operations. A restore job is the process of restoring data from the backup to the target MongoDB deployment.

Get-VEMDBRestoreJob Note:

The cmdlet returns restore jobs initiated in the PowerShell console only. The cmdlet does not return restore jobs running in the Veeam Backup & Replication console.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
CollectionName	Specifies an array of restored collections. The cmdlet will return information about the restore process performed for the specified collections.	String[]	False	Named	False
JobId	Specifies the job ID of the required restore job. The cmdlet will return information about the restore process performed for the specified database.	Guid	True	Named	True (ByValue)

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VEMDBRestore[] object that contains information about ongoing MongoDB restore jobs.

Examples

Get-VEMDBRestoreJob Example 1. Getting All Active Restore Jobs

This command gets all running restore jobs. Save the result to the $restore variable to be able to use it with other cmdlets.

$restore = Get-VEMDBRestoreJob

Get-VEMDBRestoreJob Example 2. Getting Restore Job by Job ID

This example shows how to get a specific restore job by its job ID.

$restore = Get-VEMDBRestoreJob

$restore = Get-VEMDBRestoreJob -JobId $restore.JobId[0]

Perform the following steps:

Run the Get-VEMDBRestoreJob cmdlet. Save the result to the $restore variable.

The cmdlet will return an array of active restore jobs. Note the ordinal number of the necessary restore job. In our example, it is the first restore job in the array.

Run the Get-VEMDBRestoreJob cmdlet. Set a subset of the $restore variable, containing the first value in the JobId column, as the JobId parameter value. Save the result to the $restore variable to be able to use it with other cmdlets.

Get-VEMDBRestoreJob Example 3. Getting Restore Job by Collection Name

This example shows how to get a specific restore session to perform operations with MongoDB databases.

$restore = Get-VEMDBRestoreJob

$collections = @("on-site", "off-site")

$restore = Get-VEMDBRestoreJob -CollectionName $collections

Perform the following steps:

Run the Get-VEMDBRestoreJob cmdlet. Save the result to the $restore variable.

The cmdlet will return an array of active restore jobs. Note the ordinal number of the necessary restore job. In our example, it is the first restore job in the array.

Declare the $collections variable. Assign to this variable an array with the names of the necessary MongoDB collections.
Run the Get-VEMDBRestoreJob cmdlet. Set the $collections variable as the CollectionName parameter value. Save the result to the $restore variable to be able to use it with other cmdlets.

Related Commands

Stop-VEMDBRestoreJob