Export-VEORDatabase

Short Description

Exports a backed-up Oracle database.

Applies to

Veeam Backup & Replication

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

Syntax

Export-VEORDatabase [-Database] <VEORDatabase> [-Path] <String> [-ToDateTime <DateTime>] [-Server <String>] [-WindowsCredentials <PSCredential>] [-LinuxCredentials <VEORLinuxCredential>] [-SshPort <Int32>] [-Force] [-EnableRmanBackup] [-OracleHome <String>] [-RmanBackupFormat <String>] [-RmanBackupTagName <String>] [-RmanBackupEnableCompression] [-ChannelsNumber <Int32>] [-OracleHomePassword <SecureString>] [<CommonParameters>]

Detailed Description

This cmdlet exports a backed-up Oracle database to the machine where the Veeam Backup & Replication console is installed. You can use the following export options:

  • Export the raw database files of the Oracle database. If archived redo logs are available for the selected restore point, they will be exported in the .arc format.
  • Export an Oracle database as an RMAN backup. To enable this option, use the EnableRmanBackup parameter.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Database

Specifies an Oracle database. The cmdlet will export this database.

Accepts the VEORDatabase object. To get this object, run the Get-VEORDatabase cmdlet.

True

0

True (ByValue)

Path

Specifies the target path. The cmdlet will export a database to the location specified in this path.

String

True

1

False

LinuxCredentials

Specifies Linux credentials that the cmdlet will use to connect to the Linux staging server.

Accepts the VEORLinuxCredential object. To get this object, run the New-VEORLinuxCredential cmdlet.

False

Named

False

ToDateTime

Specifies a point in time within the restore interval of an Oracle database.

The cmdlet will export the database to the state of the specified point in time.

Note: Make sure that the value you assign to this parameter is converted to Universal Coordinated Time (UTC).

DateTime

False

Named

False

Server

Specifies DNS name or IP address of the staging Oracle server.

Note: A staging server is necessary when exporting an Oracle database as an RMAN backup and when exporting database files from a backup of a Linux machine with Oracle.

String

False

Named

False

SshPort

Specifies the SSH port number. The cmdlet will use that port to connect to the Linux machine.

Default: 22

Int32

False

Named

False

WindowsCredentials

Specifies Windows credentials that the cmdlet will use to connect to the Windows staging server.

Accepts the PSCredential object. To get this object, run the Get-Credential cmdlet.

False

Named

False

Force

Defines that the cmdlet will overwrite the existing Oracle database files with the database files from the backup.

If you provide this parameter, the cmdlet will show no prompt before executing the command. Otherwise, the cmdlet will keep the existing version of Oracle database files.

SwitchParameter

False

Named

False

OracleHome

For export as RMAN backup and export of database files from backups of Linux machines.

Specifies the Oracle home path on the staging server that the cmdlet will use.

String

False

Named

False

OracleHomePassword

For export as RMAN backup for Windows machines with Oracle. For Oracle Database 12c or later.

Specifies Oracle home credentials that the cmdlet will use to start Oracle Services on the staging server.

Note that this parameter is required for the following types of Oracle Home user:

  • Existing Windows user
  • New Windows user

SecureString

False

Named

False

EnableRmanBackup

Defines that the cmdlet will export Oracle databases using Oracle RMAN.

If you do not specify this parameter, the cmdlet will not apply Oracle RMAN to export Oracle databases.

SwitchParameter

False

Named

False

RmanBackupFormat

Specifies the FORMAT parameter of backed-up database files. The cmdlet will export Oracle databases using the specified FORMAT parameter.

String

False

Named

False

RmanBackupTagName

Specifies tags of backed-up database files. The cmdlet will export Oracle databases using the specified tags.

String

False

Named

False

RmanBackupEnableCompression

Defines that the cmdlet will back up Oracle databases with compression.

If you do not specify this parameter, the cmdlet will export Oracle databases without compression.

SwitchParameter

False

Named

False

ChannelsNumber

Specifies a number of channels that will be used to export Oracle databases.

Default: 4

Permitted value: 1-255.

Int32

False

Named

False

<CommonParameters>

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

Output Object

None.

Examples

Export-VEORDatabaseExample 1. [For Windows Machines] Exporting Oracle Database as RMAN Backup

Export-VEORDatabaseExample 2. [For Windows Machines] Exporting Oracle Database Files from Backup

Export-VEORDatabaseExample 3. [For Linux Machines] Exporting Oracle Database Files from Backup

Related Commands

Page updated 3/25/2025

Page content applies to build 12.3.1.1139