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.