Move-ActiveMailboxDatabase — usage, script and reference

Quick start script

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

# 2. Run and inspect
Move-ActiveMailboxDatabase -Identity <DatabaseIdParameter> -Server <MailboxServerIdParameter> -ActivatePreferredOnServer <MailboxServerIdParameter> | Format-List

# 3. Export for evidence / drift tracking
Move-ActiveMailboxDatabase | Export-Clixml .\ActiveMailboxDatabase-$(Get-Date -Format yyyyMMdd).xml

Syntax — 4 parameter sets

ActivatePreferred

Move-ActiveMailboxDatabase [-ActivatePreferredOnServer] <MailboxServerIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MountDialOverride <DatabaseMountDialOverride>]
 [-MoveComment <String>]
 [-SkipActiveCopyChecks]
 [-SkipClientExperienceChecks]
 [-SkipCpuChecks]
 [-SkipHealthChecks]
 [-SkipLagChecks]
 [-SkipMaximumActiveDatabasesChecks]
 [-SkipMoveSuppressionChecks]
 [-TerminateOnWarning]
 [-WhatIf]
 [<CommonParameters>]

Identity

Move-ActiveMailboxDatabase [-Identity] <DatabaseIdParameter> [[-ActivateOnServer] <MailboxServerIdParameter>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MountDialOverride <DatabaseMountDialOverride>]
 [-MoveComment <String>]
 [-SkipActiveCopyChecks]
 [-SkipClientExperienceChecks]
 [-SkipCpuChecks]
 [-SkipHealthChecks]
 [-SkipLagChecks]
 [-SkipMaximumActiveDatabasesChecks]
 [-SkipMoveSuppressionChecks]
 [-TerminateOnWarning]
 [-WhatIf]
 [<CommonParameters>]

Server

Move-ActiveMailboxDatabase [-Server] <MailboxServerIdParameter> [[-ActivateOnServer] <MailboxServerIdParameter>]
 [-MoveAllDatabasesOrNone]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MountDialOverride <DatabaseMountDialOverride>]
 [-MoveComment <String>]
 [-SkipActiveCopyChecks]
 [-SkipClientExperienceChecks]
 [-SkipCpuChecks]
 [-SkipHealthChecks]
 [-SkipLagChecks]
 [-SkipMaximumActiveDatabasesChecks]
 [-SkipMoveSuppressionChecks]
 [-TerminateOnWarning]
 [-WhatIf]
 [<CommonParameters>]

SkipAllChecks

Move-ActiveMailboxDatabase [-Identity] <DatabaseIdParameter> [-ActivateOnServer] <MailboxServerIdParameter>
 [-SkipAllChecks]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MountDialOverride <DatabaseMountDialOverride>]
 [-MoveComment <String>]
 [-SkipActiveCopyChecks]
 [-SkipClientExperienceChecks]
 [-SkipCpuChecks]
 [-SkipHealthChecks]
 [-SkipLagChecks]
 [-SkipMaximumActiveDatabasesChecks]
 [-SkipMoveSuppressionChecks]
 [-TerminateOnWarning]
 [-WhatIf]
 [<CommonParameters>]

Parameters (19)

Parameter	Type	Required	What it controls
-Identity	DatabaseIdParameter	yes	The Identity parameter specifies the mailbox database that you want to activate. You can use any value that uniquely identifies the database. For example:
-Server	MailboxServerIdParameter	yes	The Server parameter specifies the server that you want to move all active mailbox databases from. You can use any value that uniquely identifies the server. For example:
-ActivatePreferredOnServer	MailboxServerIdParameter	yes	The ActivatePreferredOnServer parameter specifies the Mailbox server where you want to activate all mailbox databases that have copies with an ActivationPreference value of 1. You can use any value that uniquely...
-ActivateOnServer	MailboxServerIdParameter		The ActivateOnServer parameter specifies the name of the Mailbox server on which the mailbox database copy should be activated.
-SkipAllChecks	SwitchParameter	yes	The SkipAllChecks switch specifies whether to skip all checks. You don't need to specify a value with this switch.
-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		The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-MountDialOverride	DatabaseMountDialOverride		The MountDialOverride parameter is used to override the auto database mount dial (AutoDatabaseMountDial) setting for the target server and specify an alternate setting. Valid value are:
-MoveAllDatabasesOrNone	SwitchParameter		The MoveAllDatabasesOrNone switch specifies whether to prevent any databases from moving if a single active database on the server can't be moved. You don't need to specify a value with this switch.
-MoveComment	String		The MoveComment parameter specifies an optional administrative reason for the move operation. The comment is recorded in the Event log.
-SkipActiveCopyChecks	SwitchParameter		The SkipActiveCopyChecks switch specifies whether to skip checking the current active copy to see if it's currently a seeding source for any passive databases. You don't need to specify a value with this switch.
-SkipClientExperienceChecks	SwitchParameter		The SkipClientExperienceChecks switch specifies whether to skip the search catalog (content index) state check to see if the search catalog is healthy and up to date. You don't need to specify a value with this switch.
-SkipCpuChecks	SwitchParameter		The SkipCpuChecks switch specifies whether to skip the high CPU utilization checks. You don't need to specify a value with this switch.
-SkipHealthChecks	SwitchParameter		The SkipHealthChecks switch specifies whether to bypass passive copy health checks. You don't need to specify a value with this switch.
-SkipLagChecks	SwitchParameter		The SkipLagChecks switch specifies whether to allow a copy to be activated that has replay and copy queues outside of the configured criteria. You don't need to specify a value with this switch.
-SkipMaximumActiveDatabasesChecks	SwitchParameter		The SkipMaximumActiveDatabasesChecks switch specifies whether to skip checking the value of MaximumPreferredActiveDatabases during the best copy and server selection (BCSS) process. You don't need to specify a value...
-SkipMoveSuppressionChecks	SwitchParameter		The SkipMoveSuppressionChecks switch specifies whether to skip the move suppression checks. You don't need to specify a value with this switch.
-TerminateOnWarning	SwitchParameter		The TerminateOnWarning switch specifies whether to terminate the task and output an error message if a warning is encountered during the switchover operation. You don't need to specify a value with this switch.
-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.