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

Test-VEXMailboxResolution

Short Description

Tests the availability of mailboxes prior to a bulk mailbox restore.

Applies to

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

Test-VEXMailboxResolution [-Credential <pscredential>] [-Mailbox <VEXMailbox[]>] [-Office365Credential <pscredential>] [-Domain <string>] [-Force]  [<CommonParameters>]

Detailed Description

This cmdlet tests the availability of mailboxes prior to a bulk mailbox restore.

Test-VEXMailboxResolution Note:

This cmdlet requires the PSCredential object. Use the Get-Credential cmdlet to create the PSCredentials object. For detailed instructions on how to run Get-Credential, see this Microsoft article.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Domain

Specifies the mailbox domain.

False

Named

False

False

Force

Indicates that the cmdlet will ignore the certificated upon the connection.

False

Named

False

False

Mailbox

Specifies a mailbox. The cmdlet will check whether this mailbox is available.

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

False

Named

False

False

Office365Credential

Specifies Office 365 user credentials to connect to the backup proxy server.

False

Named

False

False

Credential

Specifies Windows user credentials to connect to the Active Directory domain and the Exchange server.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Example 1

[For Veeam Backup for Microsoft Office 365] This example shows how to test the availability of the sales mailbox.

  1. Run the Get-Credential cmdlet to create a credential object. Type Windows credentials to connect to the Veeam Backup for Microsoft Office 365 server. Save the result to the $credentials variable
  2. Run the Get-VBOExchangeItemRestoreSession cmdlet to get an active restore session. Save the result to the $session variable.
  3. Run the Get-VEXDatabase cmdlet with the $session variable to get a mailbox database. Save the result to the $database variable.
  4. Run the Get-VEXMailbox cmdlet with the $database variable and the Name parameter to get the specific mailbox from the mailbox database.
  5. Run the Test-VEXMailboxResolution cmdlet with the $mailboxes and $credentials variables.

$credentials = Get-Credential

$session = Get-VBOExchangeItemRestoreSession

$database = Get-VEXDatabase -Session $session

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

Test-VEXMailboxResolution -Mailbox $mailboxes -Domain test.local -Credential $credentials

Example 2

[For Veeam Backup & Replication] This example shows how to test the availability of Exchange database mailboxes.

  1. Run the Get-Credential cmdlet to create a credential object. Type Windows credentials to connect to the Active Directory domain and the Exchange server. Save the result to the $credentials variable
  2. Run the Get-VBRExchangeItemRestoreSession cmdlet to get an active restore session. Save the result to the $session variable.
  3. Run the Get-VEXDatabase cmdlet with the $session variable and the Name parameter to get a mailbox database. Save the result to the $database variable.
  4. Run the Get-VEXMailbox cmdlet with the $database variable to get the specific mailbox from the mailbox database.
  5. Run the Test-VEXMailboxResolution cmdlet with the $mailboxes and $credentials variables.

$credentials = Get-Credential

$session = Get-VBRExchangeItemRestoreSession

$database = Get-VEXDatabase -Session $session -Name "Mailbox Database 0754907780.edb"

$mailboxes = Get-VEXMailbox -Database $database

Test-VEXMailboxResolution -Mailbox $mailboxes -Domain test.local -Credential $credentials

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