Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2012-07-23

A mailbox export request is the process of exporting mailbox or archive data to a .pst file. You can view the properties of an export request, or you can view the statistics. The properties provide you with basic information about the status of an export request. The statistics provide you with detailed information that can be used for troubleshooting purposes.

Note:
You can't use the Exchange Management Console (EMC) to view the properties of a mailbox export request. You must use the Shell.

Looking for other management tasks related to mailbox import or export requests? Check out Managing Mailbox Import and Export Requests.

View Export Request Properties

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Import Export" entry in the Mailbox Permissions topic.

This example returns the default information about the status of the ongoing export request Tony\DB01toPST. By default, the type of information includes the name of the request, the mailbox for which the request is being performed, and the status of the request.

Copy Code
Get-MailboxExportRequest -Identity "Tony\DB01toPST"

This example returns additional information about the status of the ongoing export request Tony\DB01toPST by pipelining the results to the Format-List command.

Copy Code
Get-MailboxExportRequest -Identity "Tony\DB01toPST" | Format-List

This example returns information about export requests that have a status of In Progress and are exporting data from a mailbox or archive that resides on database DB01.

Copy Code
Get-MailboxExportRequest -Status InProgress -Database DB01

This example returns information about export requests in the Attachment_CompanyReport batch that have a status of Completed.

Copy Code
Get-MailboxExportRequest -BatchName "Attachment_CompanyReport" -Status Completed

This example returns all export requests that have the name DB01toPST and have a status of Suspended.

Copy Code
Get-MailboxExportRequest -Name "DB01toPST" -Suspend $true

For detailed syntax and parameter information, see Get-MailboxExportRequest.

Get-MailboxExportRequest Output

By default, the Get-MailboxExportRequest cmdlet returns the name of the request, the mailbox for which the request is being performed, and the status of the request. The following table lists the information that's returned if you pipeline the Format-List command:

Value Description

FilePath

This value specifies file path where the .pst file will be exported.

SourceDatabase

This value specifies the database that contains the mailbox or archive that's being exported.

Mailbox

This value specifies the user whose mailbox or archive is being exported.

Name

This value specifies the name of the export request.

RequestGUID

This value specifies the GUID of the export request.

RequestQueue

This value specifies the database on which the Microsoft Exchange Mailbox Replication service (MRS) stores the detailed status of the export request.

Flags

This value specifies flags that the cmdlet automatically sets when creating the export request.

BatchName

This value specifies a batch name. If you didn't provide a batch name, this field will be blank.

Status

This value specifies the status of the request.

Suspend

This value specifies if the request was created to be automatically suspended before completion.

Direction

This value specifies if the request is a push or a pull. For export requests, this value is always Push.

RequestStyle

This value specifies if the request is IntraOrg or CrossOrg. For Exchange 2010 SP1, this value is always IntraOrg.

Identity

This value specifies the identity of the export request.

View Export Request Statistics

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Import Export" entry in the Mailbox Permissions topic.

This example returns the default export request statistics for Tony\MailboxExport. By default, the type of information returned includes the name of the request, the mailbox for which the request is being performed, and the status of the request.

Copy Code
Get-MailboxExportRequestStatistics -Identity Tony\MailboxExport

This example returns additional information about the export request Tony\MailboxExport by using the IncludeReport parameter and by pipelining the results to the Format-List command.

Copy Code
Get-MailboxExportRequestStatistics -Identity Tony\MailboxExport -IncludeReport | Format-List 

This example returns detailed statistics for the export request Tony\MailboxExport and exports the report to a .csv file.

Copy Code
Get-MailboxExportRequestStatistics -Identity Tony\MailboxExport | Export-CSV \\ExportRequest_Reports\Tony_Exportstats.csv

This example returns additional information for all the export requests that have a status of Failed by using the IncludeReport parameter, and then saves the information to the text file AllExportReports.txt.

Copy Code
Get-MailboxExportRequest -Status Failed | Get-MailboxExportRequestStatistics -IncludeReport | Format-List > AllExportReports.txt

For detailed syntax and parameter information, see Get-MailboxExportRequestStatistics and Get-MailboxExportRequest.

Get-MailboxExportRequestStatistics Output

By default, the Get-MailboxExportRequestStatistics cmdlet returns the name of the request, the status of the request, the alias of the source mailboxes, and the percentage completed. The following table lists the information that's returned if you pipeline the Format-List command:

Value Description

Name

This value specifies the name of the request.

Status

This value specifies the status of the request.

StatusDetail

This value specifies more detailed status information about the request.

Flags

This value specifies flags that the cmdlet automatically sets when creating the export request.

RequestStyle

This value specifies if the request is IntraOrg or CrossOrg. For Exchange 2010 SP1, this value is always IntraOrg.

Suspend

If set to true, this value specifies whether an administrator suspended this request or if the request failed.

FilePath

This value specifies file path from where the .pst file is exported.

SourceAlias

This value specifies the alias of the source mailbox.

SourceExchangeGuid

This value specifies the GUID of the source mailbox or archive.

SourceRootFolder

This value specifies the name of the root folder in the mailbox's or archive's hierarchy from which the data is exported. If this value is blank, the data is exported from the folder "Top of Information Store".

IncludeFolders

This value specifies the list of folders to include during the export. If this value is blank, no folders were specified when the request was created and all folders will be exported (unless the ExcludeFolders parameter is used to exclude specific folders).

ExcludeFolders

This value specifies the list of folders to exclude during the export. If this value is blank, no folders were specified when the request was created and all folders will be exported (unless the IncludeFolders parameter is used to include specific folders).

ExcludeDumpster

This value specifies if the Recoverable Items folder was excluded when the request was created.

ConflictResolutionOption

This value specifies the action for MRS to take if there are matching messages in the target and source folders.

AssociatedMessagesCopyOption

This value specifies whether the associated messages are copied when the request is processed. Associated messages are special messages that contain hidden data with information about rules, views, and forms.

BatchName

This value specifies a batch name. If you don't provide a batch name, this field will be blank.

ContentFilter

This value specifies the OPATH content filter used to search for message content. For more information, see Filterable Properties for the -ContentFilter Parameter.

ContentFilterLanguage

This value specifies the language used in the content filter string searches.

BadItemLimit

This value specifies the number of bad items that MRS will to skip if the request encounters corrupted messages.

BadItemsEncountered

This value specifies the number of corrupted messages encountered by the command. If the number of BadItemsEncountered is greater than the BadItemLimit, the request will fail.

QueuedTimeStamp

This value specifies the time at which the request was initiated to MRS.

StartTimestamp

This value specifies the date and time at which the export started being processed by MRS.

LastUpdateTimeStamp

This value specifies the date and time at which the last change was made to the request. The change could have been made by an administrator or by MRS.

CompletionTimeStamp

This value specifies the date and time at which the request completed.

SuspendedTimeStamp

This value specifies the date and time at which the request was suspended. If the request wasn't suspended, this value will be blank.

OverallDuration

This value specifies the amount of time it took to complete the request. If the request is in a Failed state, this value specifies the amount of time between the request being initiated and the request failed. If the request hasn't completed, this value specifies the amount of time between the request being initiated and the Get-MailboxExportRequestStatistics cmdlet being run.

TotalSuspendedDuration

This value specifies the amount of time the request was in the Suspended state.

TotalFailedDuration

This value specifies the amount of time the request was in the Failed state.

TotalQueuedDuration

This value specifies the amount of time the request was in the queued state.

TotalInProgressDuration

This value specifies the amount of time the request was in the In Progress state.

TotalStalledDueToHADuration

This value specifies the amount of time the request was stalled due to high availability.

TotalTransientFailureDuration

This value specifies the amount of time the request was in the Stalled state due to a transient database failure.

MRSServerName

This value specifies the name of the Client Access server that processed the request.

EstimatedTransferSize

This value specifies the file size that was exported or MRS expects to export if the export request is still in progress.

EstimatedTransferItemCount

This value specifies the number of items that were exported or that MRS expects to export if the request is in the In Progress state.

BytesTransferred

This value specifies the number of bytes that have been transferred.

BytesTransferredPerMinute

This value specifies the average number of bytes that have been transferred per minute.

ItemsTransferred

This value specifies the number of items that have been transferred.

PercentComplete

This value specifies the percentage of the request that has been completed.

PositionInQueue

If the request hasn't started, this value specifies the request's position in the queue.

FailureCode

If there was a failure, this value specifies the failure code.

FailureType

If there was a failure, this value specifies the failure type.

Message

If there was a failure, this value specifies the failure message. This value can also specify the suspend comment.

FailureTimestamp

If the request failed, this value specifies the date and time at which the request failed.

IsValid

This value specifies if the export request was valid.

ValidationMessage

If the export request wasn't valid, this value specifies the reason.

RequestGUID

This value specifies the GUID of the export request.

RequestQueue

This value specifies the database on which MRS stores the detailed status of the export request.

Identity

This value specifies the identity of the request.

Report

If you specified the IncludeReport parameter when using the Get-MailboxExportRequest cmdlet, this value specifies information that can be used to troubleshoot the request.