This is an archive version of the document. To get the most up-to-date information, see the current version.

Test-VEXMailboxResolution

In this article

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	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Domain	Specifies a mailbox domain.	String	False	Named	False	False
Force	Indicates that the cmdlet will ignore the certificated upon the connection.	SwitchParameter	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.	PSCredential	False	Named	False	False
Credential	Specifies Windows user credentials to connect to the Active Directory domain and the Exchange server.	PSCredential	False	Named	False	False

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

Examples

Applied to Veeam Backup & Replication

Testing Specific Mailbox

Applied to Veeam Backup for Microsoft Office 365

Testing Specific Mailbox

Applied to Veeam Backup & Replication

Testing Specific Mailbox

This example shows how to test the availability of Exchange database mailboxes.

$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

You must perform the following steps:

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
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.
Run the Get-VEXMailbox cmdlet. Set the $database as the Database parameter value. Specify the Name parameter value.
Run the Test-VEXMailboxResolution cmdlet. Specify the following settings:

Set the $mailboxes variable as the Mailbox parameter value.
Specify the Domain parameter value.
Set the $credentials as the Credential parameter value.

Applied to Veeam Backup for Microsoft Office 365

Testing Specific Mailbox

This example shows how to test the availability of the specific mailbox.

$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

You must perform the following steps:

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
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.
Run the Get-VEXMailbox cmdlet. Set the $database as the Database parameter value. Specify the Name parameter value.
Run the Test-VEXMailboxResolution cmdlet. Specify the following settings:

Set the $mailboxes variable as the Mailbox parameter value.
Specify the Domain parameter value.
Set the $credentials as the Credential parameter value.

Related Commands

Get-Credential