Export-VEXItem
Exports Exchange organization backups.
Veeam Backup & Replication, Veeam Backup for Microsoft 365
Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License
This cmdlet provides parameter sets that allow you to:
- Export Exchange organization mailbox items.
Export-VEXItem -Item <VEXItem[]> -To <String> [-PstSizeLimit <UInt64>] [-Force] [<CommonParameters>] |
- Export an Exchange organization mailbox folder.
Export-VEXItem -Folder <VEXFolder> -To <String> [-PstSizeLimit <UInt64>] [-Force] [-ContentKeyword <String[]>] [<CommonParameters>] |
- Export an Exchange organization mailbox.
Export-VEXItem -Mailbox <VEXMailbox> -To <String> [-PstSizeLimit <UInt64>] [-Force] [-ContentKeyword <String[]>] [<CommonParameters>] |
- Export databases of Exchange organization mailboxes.
Export-VEXItem -Database <VEXDatabase[]> -To <String> [-PstSizeLimit <UInt64>] [-Force] [-ContentKeyword <String[]>] [<CommonParameters>] |
This cmdlet exports Exchange organization mailbox databases, mailboxes, folders and mailbox items into Personal Folder Files (PST files). Additionally, the cmdlet exports mailbox items to Outlook Message Files (MSG files).
Note |
- Before running this cmdlet, you must first start a restore session. For more information on how to start a restore session, see Start-VBOExchangeItemRestoreSession or Start-VBRExchangeItemRestoreSession.
- If you start a restore session for Veeam Backup for Microsoft 365, the report about export operations will only be sent to the user account provided in Veeam Explorer for Microsoft Exchange email settings. For more information, see Set-VEXMailSettings.
- The machine on which you are going to run restore sessions must have a 64-bit version of Microsoft Outlook 2016, Microsoft Outlook 2013 or Microsoft Outlook 2010 installed.
|
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|
Item | Specifies items of an Exchange organization mailbox. The cmdlet will export these items. | Accepts the VEXItem[] object. To get this object, run the Get-VEXItem cmdlet. | True | Named | True (ByValue) |
To | Specifies a path and a name for the PST file or a path for MSG files. To export databases, mailboxes and folders to a PST file, specify the path and the name for the PST file. The cmdlet will create the PST file with the specified name if it does not exist. To export items to MSG files, specify the path and the folder. The cmdlet will create the MSG file for each item in the folder that you specified. | String | True | Named | False |
PstSizeLimit | Specifies the size limit of the exported PST file in GB. The value must be between 1 GB and 49 GB. If the data you want to export exceeds the specified size limit, Veeam Explorer for Microsoft Exchange will create multiple PST files. | Uint64 | False | Named | False |
Force | Defines that the cmdlet will perform export operations without notifying the user. Default: False | SwitchParameter | False | Named | False |
Folder | Specifies a folder of an Exchange organization mailbox. The cmdlet will export this folder with all its subfolders. | Accepts the VEXFolder object. To get this object, run the Get-VEXFolder cmdlet. | True | Named | True (ByValue) |
ContentKeyWord | Specifies a keyword to query data for Exchange organization mailbox. The cmdlet will look for the specified keywords in all message fields (From, To, Subject, Body). After that, the cmdlet will export data that contains the specified keywords. | String[] | False | Named | False |
Mailbox | Specifies an Exchange organization mailbox that you want to export. | Accepts the VEXMailbox object. To get this object, run the Get-VEXMailbox cmdlet. | True | Named | True (ByValue) |
Database | Specifies an array of Exchange organization mailbox databases. The cmdlet will export these databases. | Accepts the VEXDatabase[] object. To get this object, run the Get-VEXDatabase cmdlet. | True | Named | True (ByValue) |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
None.
This example shows how to export mailbox items. The cmdlet will export items with the following settings: - The cmdlet will export items that contain the smith keyword.
- The cmdlet will export items from the Contacts folder to the Smith Contacts.pst file.
$session = Get-VBRExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "DB_0754907780.edb" $salesmailbox = Get-VEXMailbox -Database $database -Name "sales" $contacts = Get-VEXFolder -Mailbox $salesmailbox -Name "Contacts" $smith = Get-VEXItem -Folder $contacts -Query "smith" Export-VEXItem -Item $smith -To "C:\North Backup\Sales\Contacts\Smith\Smith Contacts.pst" |
Perform the following steps: - Get items with names containing the smith keyword om the Contacts folder:
- Run the Get-VBRExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $salesmailbox variable.
- Run the Get-VEXFolder cmdlet. Set the $salesmailbox variable as the Mailbox parameter value. Specify the Name parameter value. Save the result to the $contacts variable.
- Run the Get-VEXItem cmdlet. Set the $contacts variable as the Folder parameter value. Specify the Query parameter value. Save the result to the $smith variable.
- Run the Export-VEXitem cmdlet. Set the $smith variable as the Item parameter value. Specify the To parameter value.
|
This example shows how to export the Contacts folder to the Contacts.pst file. $session = Get-VBRExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "DB_0754907780.edb" $salesmailbox = Get-VEXMailbox -Database $database -Name "sales" $contacts = Get-VEXFolder -Mailbox $salesmailbox -Name "Contacts" Export-VEXItem -Folder $contacts -To "C:\North Backup\Sales\Contacts\Contacts.pst" |
Perform the following steps: - Get the mailbox folder:
- Run the Get-VBRExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $salesmailbox variable.
- Run the Get-VEXFolder cmdlet. Set the $salesmailbox variable as the Mailbox parameter value. Specify the Name parameter value. Save the result to the $contacts variable.
- Run the Export-VEXitem cmdlet. Set the $contacts variable as the Folder parameter value. Specify the To parameter value.
|
This example shows how to export the sales mailbox to the Sales.pst file. $session = Get-VBRExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "DB_0754907780.edb" $salesmailbox = Get-VEXMailbox -Database $database -Name "sales" Export-VEXItem -Mailbox $salesmailbox -To "C:\North Backup\Sales\Sales.pst" |
Perform the following steps: - Get the sales mailbox:
- Run the Get-VBRExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $salesmailbox variable.
- Run the Export-VEXitem cmdlet. Set the $salesmailbox variable as the Mailbox parameter value. Specify the To parameter value.
|
This example shows how to export the DB_0754907780.edb mailbox database to the DB_0754907780.pst file. $session = Get-VBRExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "DB_0754907780.edb" Export-VEXItem -Database $database -To "C:\Backup\DB_0754907780.pst" |
Perform the following steps: - Get the mailbox database:
- Run the Get-VBRExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
- Run the Export-VEXitem cmdlet. Set the $database variable as the Database parameter value. Specify the To parameter value.
|
This example shows how to export mailbox items. The cmdlet will export items with the following settings: - The cmdlet will export items that contain the smith keyword.
- The cmdlet will export items from the Contacts folder to the Smith Contacts.pst.
$session = Get-VBOExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "support3backup*" $mailbox = Get-VEXMailbox -Database $database -Name "sales" $contacts = Get-VEXFolder -Mailbox $mailbox -Name "Contacts" $smith = Get-VEXItem -Folder $contacts -Query "smith" Export-VEXItem -Item $smith -To "C:\North Backup\Sales\Contacts\Smith" |
Perform the following steps: - Get items with names containing smith from the Contacts folder:
- Run the Get-VBOExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $mailbox variable.
- Run the Get-VEXFolder cmdlet. Set the $mailbox variable as the Mailbox parameter value. Specify the Name parameter value. Save the result to the $contacts variable.
- Run the Get-VEXItem cmdlet. Set the $contacts variable as the Folder parameter value. Specify the Query parameter value. Save the result to the $smith variable.
- Run the Export-VEXitem cmdlet. Set the $smith variable as the Item parameter value. Specify the To parameter value.
|
This example shows how to export the Contacts folder to the Contacts.pst file. $session = Get-VBOExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "support3backup*" $salesmailbox = Get-VEXMailbox -Database $database -Name "sales" $contacts = Get-VEXFolder -Mailbox $salesmailbox -Name "Contacts" Export-VEXItem -Folder $contacts -To "C:\North Backup\Sales\Contacts\Contacts.pst" |
Perform the following steps: - Get the Contacts mailbox folder:
- Run the Get-VBOExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $salesmailbox variable.
- Run the Get-VEXFolder cmdlet. Set the $salesmailbox variable as the Mailbox parameter value. Specify the Name parameter value. Save the result to the $contacts variable.
- Run the Export-VEXitem cmdlet. Set the $contacts variable as the Folder parameter value. Specify the To parameter value.
|
This example shows how to export the sales mailbox to the Sales.pst file. $session = Get-VBOExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "support3backup*" $salesmailbox = Get-VEXMailbox -Database $database -Name "sales" Export-VEXItem -Mailbox $salesmailbox -To "C:\North Backup\Sales\Sales.pst" |
Perform the following steps: - Get the sales mailbox:
- Run the Get-VBOExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $database variable.
- Run the Get-VEXMailbox cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $salesmailbox variable.
- Run the Export-VEXitem cmdlet. Set the $salesmailbox variable as the Mailbox parameter value. Specify the To parameter value.
|
This example shows how to export a mailbox database to the North.pst file on the machine where the PowerShell session is running. $session = Get-VBOExchangeItemRestoreSession $database = Get-VEXDatabase -Session $session -Name "support3backup*" Export-VEXItem -Database $database -To "C:\North Backup\North.pst" |
Perform the following steps: - Get the mailbox database:
- Run the Get-VBOExchangeItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VEXDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $database variable.
- Run the Export-VEXitem cmdlet. Set the $database variable as the Database parameter value. Specify the To parameter value.
|
Related Commands
Example 1. Exporting Mailbox Items [For Veeam Backup & Replication]