View Mailbox Import Request Properties

 

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

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

The search criteria for the Get-MailboxImportRequest and Get-MailboxImportRequestStatistics cmdlets is a Boolean And statement. If you use multiple parameters, you can narrow your search and reduce your search results.

Note

You can't use the Exchange Management Console (EMC) to view the properties of a mailbox import 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.

Use the Shell to view mailbox import 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 mailbox import request Tony\Recovered. 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-MailboxImportRequest -Identity "Tony\Recovered"

This example returns detailed information about the status of the ongoing mailbox import request Tony\Recovered by using the IncludeReport parameter and by pipelining the results to the Format-List command.

Get-MailboxImportRequest -Identity "Tony\Recovered" -IncludeReport | Format-List

This example returns the information about mailbox import requests that have a status of In Progress for mailboxes or archives that reside on database DB01.

Get-MailboxImportRequest -Status InProgress -Database DB01

This example returns information about mailbox import requests in the ImportingDB1PSTs batch that have a status of Completed.

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

This example returns all mailbox import requests that have the name Recovered and have a status of Suspended.

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

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

Get-MailboxImportRequest Output

By default, the Get-MailboxImportRequest cmdlet returns the name of the request, the alias of the target mailbox, 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 the file path of the .pst file from which data is being exported.
TargetDatabase	This value specifies the database that contains the mailbox or archive to which the .pst file is being imported.
Mailbox	This value specifies the user whose mailbox or archive is being imported.
Name	This value specifies the name of the mailbox import request.
RequestGUID	This value specifies the GUID of the mailbox import request.
RequestQueue	This value specifies the database on which the Microsoft Exchange Mailbox Replication service (MRS) stores the detailed status of the mailbox import request.
Flags	This value specifies flags that the cmdlet automatically sets when creating the mailbox import request.
BatchName	This value specifies a batch name. If you didn't provide a batch name, this field is blank.
Status	This value specifies the status of the request.
Suspend	This value specifies whether the request was created to be automatically suspended before completion.
Direction	This value specifies whether the request is a push or a pull. For mailbox import requests, this value is always Pull.
RequestStyle	This value specifies whether the request is IntraOrg or CrossOrg. For Exchange Server 2010 Service Pack 1 (SP1), this value is always IntraOrg.
Identity	This value specifies the identity of the mailbox import request.

Use the Shell to view mailbox import 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 statistics for the mailbox import request for Tony Smith. 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-MailboxImportRequestStatistics -Identity Tony\MailboxImport

This example returns additional information about the mailbox import request LitigationHold for Ayla's mailbox by using the IncludeReport parameter and by pipelining the results to the Format-List command.

Get-MailboxImportRequestStatistics -Identity Ayla\LitigationHold -IncludeReport | Format-List

This example returns detailed statistics for the mailbox import request Tony\MailboxImport and exports the report to a .csv file.

Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport | Export-CSV \\SERVER01\ImportRequest_Reports\Tony_Importstats.csv 

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

Get-MailboxImportRequest -Status Failed | Get-MailboxImportRequestStatistics -IncludeReport | Format-List > AllImportReports.txt

For detailed syntax and parameter information, see Get-MailboxImportRequestStatistics and Get-MailboxImportRequest.

Get-MailboxImportRequestStatistics Output

By default, the Get-MailboxImportRequestStatistics cmdlet returns the name of the request, the status of the request, the alias of the target mailbox, 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 mailbox import request.
RequestStyle	This value specifies whether 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 whether the request failed.
FilePath	This value specifies a file path from where the .pst file is imported.
TargetAlias	This value specifies the alias of the target mailbox.
TargetIsArchive	This value specifies whether the .pst file is being imported into an archive.
TargetExchangeGuid	This value specifies the GUID of the target mailbox or archive.
TargetRootFolder	This value specifies the name of the root folder in the mailbox's or archive's hierarchy to which data is imported. If this value is blank, data is imported to the folder Top of Information Store.
TargetDatabase	This value specifies the target database to which the .pst file is being imported.
IncludeFolders	This value specifies the list of folders to include during the import. If this value is blank, no folders were specified when the request was created, and all folders will be imported to the mailbox or archive (unless the ExcludeFolders parameter is used to exclude specific folders).
ExcludeFolders	This value specifies the list of folders to exclude during the import. If this value is blank, no folders were specified when the request was created, and all folders will be imported to the mailbox or archive (unless the IncludeFolders parameter is used to include specific folders).
ExcludeDumpster	This value specifies whether 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 is blank.
BadItemLimit	This value specifies the number of bad items that MRS will skip if the request encounters corrupted messages.
BadItemsEncountered	This value specifies the number of corrupted messages encountered by the command. If the BadItemsEncountered value is greater than the BadItemLimit value, the request fails.
QueuedTimestamp	This value specifies the date and time at which the request was initiated to MRS.
StartTimestamp	This value specifies the date and time at which the import 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 is 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 failing. If the request hasn't completed, this value specifies the amount of time between the request being initiated and the Get-MailboxImportRequestStatistics 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 that the request was stalled due to a transient failure, such as a database failure or network connectivity issues.
MRSServerName	This value specifies the name of the Client Access server that processed the request.
EstimatedTransferSize	This value specifies the file size that was imported or the file size that MRS expects to import if the mailbox import request is in the In Progress state.
EstimatedTransferItemCount	This value specifies the number of items that were imported or the number of items that MRS expects to import 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 whether the mailbox import request was valid.
ValidationMessage	If the mailbox import request wasn't valid, this value specifies the reason.
RequestGUID	This value specifies the GUID of the mailbox import request.
RequestQueue	This value specifies the database on which MRS stores the detailed status of the mailbox import request.
Identity	This value specifies the identity of the request.
Report	If you specified the IncludeReport parameter when using the Get-MailboxImportRequest cmdlet, this value specifies information that can be used to troubleshoot the request.

 © 2010 Microsoft Corporation. All rights reserved.