View Move Request Properties

Applies to: Exchange Server 2010

A move request is the process of moving a mailbox from one mailbox database to another. After starting the move request process, you must wait until the Microsoft Exchange Mailbox Replication service replicates the mailbox from the source database to the target database, and the move request status is Completed.

During this waiting period, you can view the move request status by using the Exchange Management Console (EMC) or the Get-MoveRequest cmdlet in the Exchange Management Shell. (For a more detailed report, you can run the Get-MoveRequest cmdlet with the IncludeReport parameter.)

After the move request is complete, you can view the move history of the completed move request by running the Get-MailboxStatistics cmdlet with the IncludeMoveHistory parameter. You can also get the complete move request report by running the Get-MailboxStatistics cmdlet with the IncludeMoveReport parameter. Use this information to troubleshoot any errors or failures that may have occurred during the move.

Note

Move requests won't display in the result pane of the Move Request node until they are in the Queued status.

Looking for other management tasks related to move requests? Check out Managing Move Requests.

What Do You Want to Do?

  • Use the EMC to view the status of an in-progress move request
  • Use the Shell to view the status of an in-progress move request
  • Use the Shell to view a completed move request report

Use the EMC to view the status of an in-progress move request

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

You can view the status of a move request in the result pane of the Move Request node, and you can view some move request statistics by viewing the move request's property page.

  1. In the console tree, navigate to Recipient Configuration > Move Request.

    Note

    If you have multiple forests in the EMC, you'll need to navigate to the target forest's Move Request node.

  2. In the result pane, select a move request.

  3. In the action pane, click Properties.

  4. Use the General tab to view the following information about the move request:

    • Remote host name   If you are moving the mailbox across Exchange forests, this field displays the fully-qualified domain name (FQDN) of the remote host. If this is a local move, this field will be blank.
    • Move request status   This read-only field displays one of the following move request statuses:
      Auto Suspended   This status specifies that the move is ready to complete, but that when the move request was created, the SuspendWhenReadyToComplete switch was added to the command. You can resume the move request by using the Resume-MoveRequest cmdlet or by using the Complete Move Request action in the action pane. For more information, see Complete a Move Request.
      Completed This status specifies that the move request was completed successfully without any warnings. Completed with warning   This status specifies that the move request completed, but that there were warnings. For more information, see Troubleshooting Mailbox Moves.
      Completion in progress   This status specifies that the mailbox is in its final stages of being moved. If the move was an online move, at this point, the user's mailbox may become unavailable.
      Failed   This status specifies that the move request has failed. To view the message that describes why the move failed, click View located next to the Failed Message field.
      In progress   This status specifies that the move is still in progress. If this is an online mailbox move, the user will still be able to access the mailbox. If this is an offline mailbox move, the user's mailbox will be unavailable.
      Queued This status specifies that the move has been queued and is waiting to be picked up by the Microsoft Exchange Mailbox Replication service. Ready to complete   This status specifies that the move is ready to complete. In this case, you'll need to manually complete the move. For more information, see Complete a Move Request.
      Suspended   This status specifies that the move was suspended by using the Suspend-MoveRequest cmdlet. You can resume the move request by using the Resume-MoveRequest cmdlet or by using the Complete Move Request action in the action pane. For more information, see Complete a Move Request.
    • Failed message   If the move request failed, click View to view the message that describes why the move failed. This message will help you troubleshoot the failure. This button is available only if the move failed.
    • Percent complete   This field displays the completion percentage for the move request.
    • Move request queued time   This field displays the time that the move request was queued. The time may not be the same as the time the move request was created.
    • Move request start time   This field displays the time that the actual move began.
    • Duration   This field displays how long it took the move to complete.
    • Mailbox size   This field displays the size of the mailbox being moved.
    • Number of bad items   This field displays the number of bad items that were detected during the move.

Use the Shell to view the status of an in-progress move request

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

This example retrieves the status of the on-going move for Tony Smith's mailbox (tony@contoso.com).

Get-MoveRequest -Identity 'tony@contoso.com'

This example retrieves the status of on-going moves for user mailboxes in the Marketing department.

Get-User -Filter {Department -like 'Marketing'} | Get-MoveRequest

This example retrieves the status of ongoing mailbox moves to the target database DB05.

Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05

This example retrieves the status for completed move requests in the FromDB01toDB02 batch that had warnings.

Get-MoveRequest -Batchname "FromDB01ToDB02" -MoveStatus CompletedWithWarning

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

Use the Shell to view a completed move request report

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

This example uses the IncludeMoveHistory parameter to retrieve the move history of a completed move request for Tony Smith's mailbox.

Get-MailboxStatistics -Identity tony@contoso.com -IncludeMoveHistory

This example uses the IncludeMoveReport parameter to retrieve a detailed move report for a failed move request of Ayla Kol's mailbox.

Get-MailboxStatistics -Identity ayla@contoso.com -IncludeMoveReport

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

Other Tasks

After the move is complete, you can clear the move requests from the result pane of the EMC. For detailed instructions, see Create a Remote Legacy Move Request Where One of the Forests Doesn't Have Exchange 2010.

If the move failed, you may want to troubleshoot the move to determine the cause of the failure. For more information, see Troubleshooting Mailbox Moves.

For More Information

Understanding Move Requests