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.

False

Named

False

False

Office365Credential

Specifies Office 365 user credentials to connect to the 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 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 test the availability of the sales mailbox.

  1. Run Get-Credential 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 Get-VBOExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  3. Run Get-VEXDatabase with the $session variable to get a mailbox database. Save the result to the $database variable.
  4. Run Get-VEXMailbox with the $database variable and the Name parameter to get the specific mailbox from the mailbox database.
  5. Run Test-VEXMailboxResolution with the $mailboxes and $credentials variables.

PS C:\PS> $credentials = Get-Credential

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

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

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

PS C:\PS> 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 Get-Credential 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 Get-VBRExchangeItemRestoreSession to get an active restore session. Save the result to the $session variable.
  3. Run Get-VEXDatabase with the $session variable and the Name parameter to get a mailbox database. Save the result to the $database variable.
  4. Run Get-VEXMailbox with the $database variable to get the specific mailbox from the mailbox database.
  5. Run Test-VEXMailboxResolution with the $mailboxes and $credentials variables.

PS C:\PS> $credentials = Get-Credential

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

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

PS C:\PS> $mailboxes = Get-VEXMailbox -Database $database

PS C:\PS> 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