Get-VEORDatabase

Short Description

Returns backed-up Oracle databases.

Product: Veeam Backup & Replication

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Get-VEORDatabase [-Session] <VEORRestoreSession> [[-Name] <String[]>] [-OracleHome <String[]>] [<CommonParameters>]

Detailed Description

This cmdlet returns an array of backed-up Oracle databases. After you get backed-up Oracle databases, you can restore these databases.

Run the Restore-VEORDatabase cmdlet to restore Oracle databases.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Name	Specifies an array of names for Oracle databases. The cmdlet will return information about databases with the specified names.	`String[]`	False	1	False
OracleHome	Specifies an array of names of an Oracle home path. The cmdlet will return the Oracle home paths with the specified names.	`String[]`	False	Named	False
Session	Specifies an active restore session. The cmdlet will return an array of Oracle databases within the specified restore session. Accepts the `VEORRestoreSession` object. To get this object, run the `Get-VEORRestoreSession` cmdlet.	`VEORRestoreSession`	True	0	True (ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

The cmdlet returns the VEORDatabase[] array that contains backed-up Oracle databases.

Examples

Get-VEORDatabase Example 1. Getting All Oracle Databases Within Specified Restore Session

This example shows how to get a list of all Oracle databases within the specified restore session.

$session = Get-VEORRestoreSession

Get-VEORDatabase -Session $session[0]

Perform the following steps:

Run the Get-VEORRestoreSession 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 this example, it is the first restore session in the array.
Run the Get-VEORDatabase cmdlet. Set the $session variable as the Session parameter value.

Get-VEORDatabase Example 2. Getting Oracle Databases with Specified Name

This example shows how to get all Oracle databases with a specific name within the specified restore session.

$session = Get-VEORRestoreSession

Get-VEORDatabase -Session $session[0] -Name "orcl"

Perform the following steps:

Run the Get-VEORRestoreSession 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 this example, it is the first restore session in the array.
Run the Get-VEORDatabase cmdlet. Set the $session variable as the Session parameter value and select the necessary restore session. Specify the Name parameter value.

Get-VEORDatabase Example 3. Getting Oracle Databases with Specific Names Located in Specific Oracle Home Directories

This example shows how to get Oracle databases with the specified names that are located in the specified Oracle Home directories.

$session = Get-VEORRestoreSession

$dbnames = @("orcl1", "orcl2")

$oraclehomepaths = @("E:\app\administrator\product\19.3.0\dbhome_1", "E:\app\administrator\product\19.3.0\dbhome_2")

Get-VEORDatabase -Session $session[0] -Name @dbnames -OracleHome @oraclehomepaths

Perform the following steps:

Run the Get-VEORRestoreSession 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 this example, it is the first restore session in the array.
Declare the $dbnames variable. Assign to this variable an array with the names of the necessary Oracle databases.
Declare the $oraclehomepaths variable. Assign to this variable an array with the necessary Oracle Home paths.
Run the Get-VEORDatabase cmdlet. Set the $session variable as the Session parameter value and select the necessary restore session. Set the @dbnames variable as the Name parameter value. Set the @oraclehomepaths variable as the OracleHome parameter value.

Get-VEORRestoreSession