New-VEMDBCollectionRestoreOptions - Veeam Explorers PowerShell Reference

New-VEMDBCollectionRestoreOptions [-Collection] <VEMDBCollection> [-NewCollectionName <String>] [-NewDatabaseName <String>] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Collection	Specifies a backed-up MongoDB collection to which the settings will apply.	Accepts the VEMDBCollection object. To get this object, run the Get-VEMDBCollection cmdlet.	True	1	True (ByValue)
NewDatabaseName	Specifies the name of the database to which the collection will be restored.	String	False	Named	False
NewCollectionName	Specifies the new name of the restored collection.	String	False	Named	False

This example specifies restore options for the home office collection. The collection will be restored with its original name, to the original database.

$session = Get-VEMDBRestoreSession

$collection = Get-VEMDBCollection $session[0] -Name "home office"

$restoreoptions = New-VEMDBCollectionRestoreOptions -Collection $collection

Perform the following steps:

Run the Get-VEMDBRestoreSession cmdlet. Save the result to the $session variable.

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

Run the Get-VEMDBCollection cmdlet. Set the $session variable as the Session parameter value and specify the necessary restore session. Specify the Name parameter value. Save the result to the $collection variable.
Run the New-VEMDBCollectionRestoreOptions cmdlet and set the $collection variable as the Collection parameter value. Save the result to the $restoreoptions variable to use it with other cmdlets.

This example specifies restore settings for the first collection in the employees database. The collection will be restored with a new name, to the original database.

$session = Get-VEMDBRestoreSession

$database = Get-VEMDBDatabase -Session $session[0] -Name "employees"

$collection = Get-VEMDBCollection -Database $database[0]

$restoreoptions = New-VEMDBCollectionRestoreOptions -Collection $collection -NewCollectionName "home office"

Perform the following steps:

Run the Get-VEMDBRestoreSession cmdlet. Save the result to the $session variable.

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

Run the Get-VEMDBDatabase cmdlet. Set the $session variable as the Session parameter value and select the necessary session. Specify the Name parameter value. Save the result to the $database variable.
Run the Get-VEMDBCollection cmdlet. Set the $database variable as the Database parameter value and select the necessary database.
Run the New-VEMDBCollectionRestoreOptions cmdlet and set the $collection variable as the Collection parameter value. Specify the NewCollectionName parameter value. Save the result to the $restoreoptions variable to use it with other cmdlets.

This example specifies restore settings for the first collection in the customers database. The collection will be restored with the original name, to a new database.

$session = Get-VEMDBRestoreSession

$database = Get-VEMDBDatabase -Session $session[0] -Name "customers"

$collection = Get-VEMDBCollection -Database $database[0]

$restoreoptions = New-VEMDBCollectionRestoreOptions -Collection $collection -NewDatabaseName "sydney"

Perform the following steps:

Run the Get-VEMDBRestoreSession cmdlet. Save the result to the $session variable.

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

Run the Get-VEMDBDatabase cmdlet. Set the $session variable as the Session parameter value and select the necessary restore session. Specify the Name parameter value. Save the result to the $database variable.
Run the Get-VEMDBCollection cmdlet. Set the $database variable as the Database parameter value and select the necessary database. Save the result to the $collection variable.
Run the New-VEMDBCollectionRestoreOptions cmdlet and set the $collection variable as the Collection parameter value. Specify the NewDatabaseName parameter value. Save the result to the $restoreoptions variable to use it with other cmdlets.