Send-VEXItem

Short Description

Sends Exchange mailbox items as attachments to emails.

Applies to

Veeam Backup & Replication, Veeam Backup for Microsoft 365

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

Syntax

Send-VEXItem [-Item] <VEXItem[]> -To <string> [-From <string>] [-Subject <string>] [-Body <string>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet sends Exchange mailbox items as attachments to emails.

Send-VEXItem Note:

Before sending Exchange mailbox items, you must perform the following actions:

Specify email settings for Veeam Explorer for Microsoft Exchange. For more information on how to specify email settings, see Set-VEXMailSettings.
Start a restore session. For more information on how to start a restore session, see Start-VBOExchangeItemRestoreSession or Start-VBRExchangeItemRestoreSession.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Item	Specifies items of the Exchange organization mailbox. The cmdlet will send these items as attachments to email.	Accepts the VEXItem[] object. To get this object, run the Get-VEXItem cmdlet.	True	0	True (ByValue)
To	Specifies an email address to which Veeam Explorer for Microsoft Exchange will send restored mailbox data.	String	True	Named	False
From	Specifies the email address from which Veeam Explorer for Microsoft Exchange will send restored mailbox data. If this parameter is omitted, Veeam Explorer for Microsoft Exchange will use the email address specified in the email settings.	String	False	Named	False
Subject	Specifies a subject of an email message.	String	False	Named	False
Body	Specifies a body of an email message.	String	False	Named	False
Force	Defines that the cmdlet will skip the certificate check of the recipient. If you provide this parameter, the cmdlet will send Exchange items without checking whether the recipient certificate is valid. Otherwise, the cmdlet will not send Exchange items if the recipient certificate validation fails.	SwitchParameter	False	Named	False

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

Send-VEXItem Example 1. Sending Exchange Mailbox Items [For Veeam Backup & Replication]

This example shows how to send items that were restored from the Contacts folder with the following settings:

The cmdlet will send restored items from to the admin.north@support.com to sales.north@support.com email message.
The subject of the email message is Sales Contacts.
The body of the email message is Please find attached "North Sales" Contacts.

$session = Get-VBRExchangeItemRestoreSession

$database = Get-VEXDatabase -Session $session -Name "DB_0754907780.edb"

$mailbox = Get-VEXMailbox -Database $database -Name "Sales"

$contacts = Get-VEXFolder -Mailbox $mailbox

$items = Get-VEXItem -Folder $contacts -Recurse

Send-VEXItem -Item $items -From admin.north@support.com -To sales.north@support.com -Subject "Sales Contacts" -Body "Please find attached "North Sales" Contacts"

Perform the following steps:

Get items from 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 $mailbox variable.
Run the Get-VEXFolder cmdlet. Set the $mailbox variable as the Mailbox parameter value. Save the result to the $contacts variable.
Run the Get-VEXitem cmdlet. Set the $contacts variable as the Folder parameter value. Provide the Recurse parameter. Save the result to the $items variable.

Run the Send-VEXItem with the $items variable to send all items from the Contacts folder.

Send-VEXItem Example 2. Sending Exchange Mailbox Items [For Veeam Backup for Microsoft 365]

This example shows how to send items that were restored from the Contacts folder with the following settings:

The cmdlet will send restored items from to the admin.north@support.com to sales.north@support.com email message.
The subject of the email message is Sales Contacts.
The body of the email message is Please find attached "North Sales" Contacts.

$session = Get-VBOExchangeItemRestoreSession

$database = Get-VEXDatabase -Session $session -Name support3backup.onmicrosoft.com

$mailbox = Get-VEXMailbox -Database $database -Name "sales"

$contacts = Get-VEXFolder -Mailbox $mailbox

$items = Get-VEXItem -Folder $contacts -Recurse

Send-VEXItem -Item $items -From admin.north@support.com -To sales.north@support.com -Subject "Sales Contacts" -Body "Please find attached "North Sales" Contacts"

Perform the following steps:

Get items 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. 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. Save the result to the $contacts variable.
Run the Get-VEXitem cmdlet. Set the $contacts variable as the Folder parameter value. Provide the Recurse parameter. Save the result to the $items variable.

Run the Send-VEXItem with the $items variable to send all items from the Contacts folder.

Related Commands