Commands › Exchange Online

Set-MoveRequest

Exchange Online ExchangeOnlineManagement Set-*

Change move request options after the move request is created. You can use the Set-MoveRequest cmdlet to recover from failed move requests.

Quick start script

# Set-MoveRequest — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-MoveRequest
$before | Format-List

# 3. Make the change (dry run first)
Set-MoveRequest -Identity <MoveRequestIdParameter> -WhatIf
Set-MoveRequest -Identity <MoveRequestIdParameter>

# 4. Verify and diff
$after = Get-MoveRequest
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-MoveRequest [-Identity] <MoveRequestIdParameter>
 [-AcceptLargeDataLoss]
 [-ArchiveTargetDatabase <DatabaseIdParameter>]
 [-BadItemLimit <Unlimited>]
 [-BatchName <String>]
 [-CompleteAfter <DateTime>]
 [-CompletedRequestAgeLimit <Unlimited>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-IgnoreRuleLimitErrors <Boolean>]
 [-IncrementalSyncInterval <TimeSpan>]
 [-InternalFlags <InternalMrsFlag[]>]
 [-LargeItemLimit <Unlimited>]
 [-MoveOptions <MultiValuedProperty>]
 [-PreventCompletion <Boolean>]
 [-Priority <RequestPriority>]
 [-Protect <Boolean>]
 [-ProxyToMailbox <MailboxIdParameter>]
 [-RemoteCredential <PSCredential>]
 [-RemoteGlobalCatalog <Fqdn>]
 [-RemoteHostName <Fqdn>]
 [-RequestExpiryInterval <Unlimited>]
 [-SkipMoving <SkippableMoveComponent[]>]
 [-SkippedItemApprovalTime <DateTime>]
 [-SourceEndpoint <MigrationEndpointIdParameter>]
 [-StartAfter <DateTime>]
 [-SuspendWhenReadyToComplete <Boolean>]
 [-TargetDatabase <DatabaseIdParameter>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (29)

Parameter	Type	Required	What it controls
-Identity	MoveRequestIdParameter	yes	The Identity parameter specifies the identity of the mailbox or mail user. You can use the following values:
-AcceptLargeDataLoss	SwitchParameter		The AcceptLargeDataLoss switch specifies the request should continue even if a large number of items in the source mailbox can't be copied to the target mailbox. You don't need to specify a value with this switch.
-ArchiveTargetDatabase	DatabaseIdParameter		This parameter is available only in on-premises Exchange.
-BadItemLimit	Unlimited		This parameter is available only in on-premises Exchange.
-BatchName	String		The BatchName parameter specifies a different name for a batch.
-CompleteAfter	DateTime		The CompleteAfter parameter specifies a delay before the request is completed. The request is started, but not completed until the date/time you specify with this parameter.
-CompletedRequestAgeLimit	Unlimited		The CompletedRequestAgeLimit parameter specifies how long the request is kept after it has completed before being automatically removed. The default CompletedRequestAgeLimit parameter value is 30 days.
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-IgnoreRuleLimitErrors	Boolean		The IgnoreRuleLimitErrors parameter specifies whether the command moves the user's rules to the target server running Microsoft Exchange.
-IncrementalSyncInterval	TimeSpan		The IncrementalSyncInterval parameter specifies the wait time between incremental syncs. Use this parameter with the CompleteAfter parameter to create a move request that does periodic incremental syncs after the...
-InternalFlags	InternalMrsFlag[]		This parameter is available only in on-premises Exchange.
-LargeItemLimit	Unlimited		This parameter is available only in on-premises Exchange.
-MoveOptions	MultiValuedProperty		The MoveOptions parameter specifies the stages of the move that you want to skip for debugging purposes. Don't use this parameter unless you're directed to do so by Microsoft Customer Service and Support or specific...
-PreventCompletion	Boolean		The PreventCompletion parameter specifies whether to run the move request, but not allow it to complete. Valid values are:
-Priority	RequestPriority		This parameter is available only in on-premises Exchange.
-Protect	Boolean		This parameter is available only in on-premises Exchange.
-ProxyToMailbox	MailboxIdParameter		This parameter is available only in the cloud-based service.
-RemoteCredential	PSCredential		The RemoteCredential parameter specifies the username and password an administrator who has permission to perform the mailbox move.
-RemoteGlobalCatalog	Fqdn		The RemoteGlobalCatalog parameter specifies the FQDN of the global catalog server for the remote forest.
-RemoteHostName	Fqdn		The RemoteHostName parameter specifies the FQDN of the cross-forest organization from which you're moving the mailbox.
-RequestExpiryInterval	Unlimited		The RequestExpiryInterval parameter specifies an age limit for a completed or failed request. When you use this parameter, the completed or failed request is automatically removed after the specified interval...
-SkipMoving	SkippableMoveComponent[]		This parameter is replaced by the MoveOptions parameter.
-SourceEndpoint	MigrationEndpointIdParameter		This parameter is available only in the cloud-based service.
-StartAfter	DateTime		The StartAfter parameter specifies a delay before the request is started. The request isn't started until the date/time you specify with this parameter.
-SkippedItemApprovalTime	DateTime		This parameter is available only in the cloud-based service.
-SuspendWhenReadyToComplete	Boolean		The SuspendWhenReadyToComplete parameter specifies whether to suspend the move request before it reaches the status of CompletionInProgress. Instead of this parameter, we recommend using CompleteAfter parameter.
-TargetDatabase	DatabaseIdParameter		This parameter is available only in on-premises Exchange.
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.