Commands › Exchange Online
Add-MailboxDatabaseCopy
Create a passive copy of an existing active mailbox database.
Quick start script
# Add-MailboxDatabaseCopy — 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
Add-MailboxDatabaseCopy -Identity <DatabaseIdParameter> -MailboxServer <MailboxServerIdParameter> | Format-List
# 3. Export for evidence / drift tracking
Add-MailboxDatabaseCopy | Export-Clixml .\MailboxDatabaseCopy-$(Get-Date -Format yyyyMMdd).xmlSyntax
Add-MailboxDatabaseCopy [-Identity] <DatabaseIdParameter> [-MailboxServer] <MailboxServerIdParameter>
[-ActivationPreference <UInt32>]
[-ConfigurationOnly]
[-Confirm]
[-DomainController <Fqdn>]
[-ReplayLagMaxDelay <EnhancedTimeSpan>]
[-ReplayLagTime <EnhancedTimeSpan>]
[-SeedingPostponed]
[-TruncationLagTime <EnhancedTimeSpan>]
[-WhatIf]
[<CommonParameters>]Parameters (11)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | DatabaseIdParameter | yes | The Identity parameter specifies the mailbox database that's being copied. You can use any value that uniquely identifies the database. For example: |
| -MailboxServer | MailboxServerIdParameter | yes | The MailboxServer parameter specifies the name of the server that hosts the database copy. This server must be a member of the same DAG and must not already host a copy of the database. |
| -ActivationPreference | UInt32 | The ActivationPreference parameter value is used as part of Active Manager's best copy selection process and to redistribute active mailbox databases throughout the DAG when using the RedistributeActiveDatabases.ps1... | |
| -ConfigurationOnly | SwitchParameter | The ConfigurationOnly switch allows database copies to be added without invoking automatic seeding. 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... | |
| -ReplayLagMaxDelay | EnhancedTimeSpan | The ReplayLagMaxDelay parameter specifies the maximum delay for lagged database copy play down (also known as deferred lagged copy play down). If the disk read IO latency is greater than 25 ms, lagged copy play down... | |
| -ReplayLagTime | EnhancedTimeSpan | The ReplayLagTime parameter specifies the amount of time that the Microsoft Exchange Replication service waits before replaying log files that have been copied to the database copy. | |
| -SeedingPostponed | SwitchParameter | The SeedingPostponed switch specifies that the task doesn't seed the database copy, so you need to explicitly seed the database copy. You don't need to specify a value with this switch. | |
| -TruncationLagTime | EnhancedTimeSpan | The TruncationLagTime parameter specifies the amount of time that the Microsoft Exchange Replication service waits before truncating log files that have replayed into a copy of the database. The time period begins... | |
| -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.