Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
Veeam Explorers PowerShell Reference

Get-VEXItem

Short Description

Returns mailbox items.

Applies to

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides the following parameter sets.

  • To get mailbox items from a mailbox database:

Get-VEXItem -Database <VEXDatabase[]> [-Query <string>]  [<CommonParameters>]

  • To get mailbox items from a mailbox:

Get-VEXItem -Mailbox <VEXMailbox> [-Query <string>]  [<CommonParameters>]

  • To get mailbox items from a folder:

Get-VEXItem -Folder <VEXFolder> [-Query <string>] [-Recurse]  [<CommonParameters>]

Detailed Description

This cmdlet returns mailbox items. You can search the folder, mailbox or the entire mailbox database to get the necessary item.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Database

Specifies a mailbox database. The cmdlet will return items from this database.

True

Named

True (ByValue)

False

Mailbox

Specifies a mailbox. The cmdlet will return items from this mailbox.

True

Named

True (ByValue)

False

Folder

Specifies a mailbox folder. The cmdlet will return items from this folder.

True

Named

True (ByValue)

False

Query

Allows using keywords for mailbox item search. The cmdlet will return items that match the search query from the specified folder, database or mailbox.

False

Named

False

True

Recurse

Indicates that the cmdlet will return items from all subfolders of the specified parent folder.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

[For Veeam Backup for Microsoft Office 365] This example shows how to get mailbox items with names containing support from a mailbox database.

  1. Get the mailbox database:
  1. Run Get-VBOExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable to get the mailbox database. Save the result to the $database variable.
  1. Run Get-VEXitem with the $database variable and the Query parameter to get items with names containing a specified keyword.

PS C:\PS> $session = Get-VBOExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session

PS C:\PS> Get-VEXItem -Database $database -Query "support"

Example 2

[For Veeam Backup for Microsoft Office 365] This example shows how to get mailbox items from the north.sales mailbox.

  1. Get the north.sales mailbox:
  1. Run Get-VBOExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable to get a mailbox database. Save the result to the $database variable.
  3. Run Get-VEXMailbox with the $database variable and the Name parameter. Save the result to the $salesmailbox variable.
  1. Run Get-VEXitem with the $salesmailbox variable to get items from the north.sales mailbox.

PS C:\PS> $session = Get-VBOExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session

PS C:\PS> $salesmailbox = Get-VEXMailbox -Database $database -Name "sales"

PS C:\PS> Get-VEXItem -Mailbox $salesmailbox

Example 3

[For Veeam Backup for Microsoft Office 365] This example shows how to get items from the Contacts mailbox folder.

  1. Get the Contacts folder:
  1. Run Get-VBOExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable to get a mailbox database. Save the result to the $database variable.
  3. Run Get-VEXMailbox with the $database variable and the Name parameter to get the specific mailbox from the mailbox database. Save the result to the $mailbox variable.
  4. Run Get-VEXFolder with the $mailbox variable and the Name parameter to get the specific folder from the mailbox. Save the result to the $contacts variable.
  1. Run Get-VEXitem with the $contacts variable to get items from the Contacts folder. Use the Recurse parameter to get items from the Contacts folder and its subfolders.

PS C:\PS> $session = Get-VBOExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session

PS C:\PS> $mailbox = Get-VEXMailbox -Database $database -Name "sales"

PS C:\PS> $contacts = Get-VEXFolder -Mailbox $mailbox

PS C:\PS> Get-VEXItem -Folder $contacts -Recurse

Example 4

[For Veeam Backup & Replication] This example shows how to get mailbox items with names containing the support form in a mailbox database.

  1. Get a mailbox database:
  1. Run Get-VBRExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable and the Name parameter to get the Mailbox Database 0754907780.edb database. Save the result to the $database variable.
  1. Run Get-VEXitem with the $database variable and the Query parameter to get items with names containing a specified keyword.

PS C:\PS> $session = Get-VBRExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session -Name “Mailbox Database 0754907780.edb”

PS C:\PS> Get-VEXItem -Database $database -Query "support"

Example 5

[For Veeam Backup & Replication] This example shows how to get mailbox items from the north.sales mailbox.

  1. Get the north.sales mailbox:
  1. Run Get-VBRExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable and the Name parameter to get the Mailbox Database 0754907780.edb database. Save the result to the $database variable.
  3. Run Get-VEXMailbox with the $database variable and the Name parameter. Save the result to the $salesmailbox variable.
  1. Run Get-VEXitem with the $salesmailbox variable to get items from the north.sales mailbox.

PS C:\PS> $session = Get-VBRExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session -Name “Mailbox Database 0754907780.edb”

PS C:\PS> $salesmailbox = Get-VEXMailbox -Database $database -Name "Sales"

PS C:\PS> Get-VEXItem -Mailbox $salesmailbox

Example 6

[For Veeam Backup & Replication] This example shows how to get items from the Contacts mailbox folder.

  1. Get the Contacts folder:
  1. Run Get-VBRExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable and the Name parameter to get the Mailbox Database 0754907780.edb database. Save the result to the $database variable.
  3. Run Get-VEXMailbox with the $database variable and the Name parameter to get the specific mailbox from the mailbox database. Save the result to the $mailbox variable.
  4. Run Get-VEXFolder with the $mailbox variable and the Name parameter to get the specific folder from the mailbox. Save the result to the $contacts variable.
  1. Run Get-VEXitem with the $contacts variable to get items from the Contacts folder. Use the Recurse parameter to get items from the Contacts folder and its subfolders.

PS C:\PS> $session = Get-VBRExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session -Name “Mailbox Database 0754907780.edb”

PS C:\PS> $mailbox = Get-VEXMailbox -Database $database -Name "Sales"

PS C:\PS> $contacts = Get-VEXFolder -Mailbox $mailbox -Name "Contacts"

PS C:\PS> Get-VEXItem -Folder $contacts -Recurse

Related Commands

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions

Veeam Availability for Nutanix AHV

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation