Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2
Topic Last Modified: 2011-09-07
Use the Move-ActiveMailboxDatabase cmdlet to perform a database switchover and specify a Mailbox server host for the active copy of a mailbox database. You can also use the Move-ActiveMailboxDatabase cmdlet to perform a server switchover.
Syntax
Move-ActiveMailboxDatabase -Identity
<DatabaseIdParameter> [-ActivateOnServer
<MailboxServerIdParameter>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-MountDialOverride <None | Lossless | GoodAvailability |
BestAvailability | BestEffort>] [-MoveComment <String>]
[-SkipActiveCopyChecks <SwitchParameter>]
[-SkipClientExperienceChecks <SwitchParameter>]
[-SkipHealthChecks <SwitchParameter>] [-SkipLagChecks
<SwitchParameter>] [-TerminateOnWarning
<SwitchParameter>] [-WhatIf [<SwitchParameter>]]
|
Move-ActiveMailboxDatabase -Server
<MailboxServerIdParameter> [-ActivateOnServer
<MailboxServerIdParameter>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-MountDialOverride <None | Lossless | GoodAvailability |
BestAvailability | BestEffort>] [-MoveComment <String>]
[-TerminateOnWarning <SwitchParameter>] [-WhatIf
[<SwitchParameter>]]
|
Detailed Description
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the"Mailbox Database Copy Permissions" section in the High Availability Permissions topic.
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
The Identity parameter specifies the identity of the mailbox database being activated. |
Server |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter |
The Server parameter specifies the identity of the server from which to move all active mailbox databases. |
ActivateOnServer |
Optional |
Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter |
The ActivateOnServer parameter specifies the name of the Mailbox server on which the mailbox database copy should be activated. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. |
MountDialOverride |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.DatabaseMountDialOverride |
The MountDialOverride parameter is used to override the auto mount dial setting for the target server and specify an alternate setting. Possible values are:
|
MoveComment |
Optional |
System.String |
The MoveComment parameter specifies an optional administrative reason for the move operation. The comment is recorded in the Event log. |
SkipActiveCopyChecks |
Optional |
System.Management.Automation.SwitchParameter |
The SkipActiveCopyChecks parameter specifies whether to skip checking the current active copy to see if it is currently a seeding source for any passive databases. Be aware that when using this parameter you can move a database that is currently a seeding source, which cancels the seed operation. |
SkipClientExperienceChecks |
Optional |
System.Management.Automation.SwitchParameter |
The SkipClientExperienceChecks parameter specifies whether to skip the search catalog (content index) state check to see if the search catalog is healthy and up to date. If the search catalog for the database copy you're activating is in an unhealthy or unusable state and you use this parameter to skip the search catalog health check and activate the database copy, you will need to either re-crawl or reseed the search catalog. |
SkipHealthChecks |
Optional |
System.Management.Automation.SwitchParameter |
The SkipHealthChecks parameter specifies whether to bypass passive copy health checks. With the SkipHealthChecks parameter, you can move the active copy to a database copy that's in the Failed state. This parameter should be used only if the initial attempt to move the active database has failed. This is because SkipHealthChecks performs additional validation to ensure that the log files are consistent, which can take a considerable amount of time. |
SkipLagChecks |
Optional |
System.Management.Automation.SwitchParameter |
The SkipLagChecks parameter specifies whether to allow a copy to be activated that has replay and copy queues outside of the configured criteria. |
TerminateOnWarning |
Optional |
System.Management.Automation.SwitchParameter |
The TerminateOnWarning parameter specifies whether to terminate the task and output an error message if a warning is encountered during the switchover operation. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. |
Input Types
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
Return Types
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.
Errors
Error | Description |
---|---|
|
|
Examples
EXAMPLE 1
This example performs a switchover of a database named DB2 to a Mailbox server named MBX1. When the command completes, MBX1 hosts the active copy of DB2. Because the MountDialOverride parameter is set to None, MBX1 mounts the database using its own defined database auto mount dial settings.
Copy Code | |
---|---|
Move-ActiveMailboxDatabase DB2 -ActivateOnServer MBX1 -MountDialOverride:None |
EXAMPLE 2
This example performs a switchover of a database named DB1 to a Mailbox server named MBX3. When the command completes, MBX3 hosts the active copy of DB1. Because the MountDialOverride parameter is specified with a value of Good Availability, MBX3 mounts the database using a database auto mount dial setting of GoodAvailability.
Copy Code | |
---|---|
Move-ActiveMailboxDatabase DB1 -ActivateOnServer MBX3 -MountDialOverride:GoodAvailability |
EXAMPLE 3
This example performs a switchover of a database named DB3 to a Mailbox server named MBX4. When the command completes, MBX4 hosts the active copy of DB3. Because the MountDialOverride parameter isn't specified, MBX4 mounts the database using a database auto mount dial setting of Lossless.
Copy Code | |
---|---|
Move-ActiveMailboxDatabase DB3 -ActivateOnServer MBX4 |
EXAMPLE 4
This example performs a server switchover for a Mailbox server named MBX1. All active mailbox database copies on MBX1 will be activated on one or more other Mailbox servers with healthy copies of the active databases on MBX1.
Copy Code | |
---|---|
Move-ActiveMailboxDatabase -Server MBX1 |