View Mailbox Export Request Properties

 

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

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.

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.

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.

Get-MailboxExportRequest -Status InProgress -Database DB01

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

Get-MailboxExportRequest -BatchName "Attachment_CompanyReport" -Status Completed

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

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.

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.

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.

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.

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.

 © 2010 Microsoft Corporation. All rights reserved.