Add-MailboxDatabaseCopy

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Add-MailboxDatabaseCopy cmdlet 可以创建现有主动邮箱数据库的被动副本。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Add-MailboxDatabaseCopy
   [-Identity] <DatabaseIdParameter>
   [-MailboxServer] <MailboxServerIdParameter>
   [-ActivationPreference <UInt32>]
   [-ConfigurationOnly]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ReplayLagMaxDelay <EnhancedTimeSpan>]
   [-ReplayLagTime <EnhancedTimeSpan>]
   [-SeedingPostponed]
   [-TruncationLagTime <EnhancedTimeSpan>]
   [-WhatIf]
   [<CommonParameters>]

说明

若要使用 Add-MailboxDatabaseCopy cmdlet 添加邮箱数据库副本，必须满足以下条件：

指定邮箱服务器必须处于相同数据库可用性组 (DAG) 中，并且 DAG 必须具有仲裁且状态正常。
指定的邮箱服务器不得托管指定邮箱数据库的副本。
由指定的数据库使用的数据库路径还必须在指定的邮箱服务器上可用，因为一个数据库的所有副本都必须使用同一个路径。
如果您要添加数据库的第二个副本（例如，添加数据库的第一个被动副本），则不得为指定邮箱数据库启用循环日志记录。如果已启用循环日志记录，则必须首先禁用它。在添加邮箱数据库副本之后，才可以启用循环日志记录。在为复制邮箱数据库启用循环日志记录之后，会使用连续复制循环日志记录 (CRCL) 而不是 JET 循环日志记录。如果您要添加数据库的第三个或后续副本，则 CRCL 可以保留为已启用。

如果指定了 SeedingPostponed 参数，则在运行 Add-MailboxDatabaseCopy cmdlet 之后，新副本将保持“已挂起”状态。当数据库复制状态设置为“已挂起”时，SuspendMessage 将设置为“数据库复制'{0}'的复制已暂停，因为数据库需要种子设定种子”。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Add-MailboxDatabaseCopy -Identity DB1 -MailboxServer MBX3 -ReplayLagTime 00:10:00 -TruncationLagTime 00:15:00 -ActivationPreference 2

本示例向邮箱服务器 MBX3 中添加邮箱数据库 DB1 的副本。重播延迟时间和截断延迟时间的值分别配置为 10 分钟和 15 分钟。激活首选项的值配置为 2。

示例 2

Add-MailboxDatabaseCopy -Identity DB2 -MailboxServer MBX1 -ActivationPreference 3

本示例向邮箱服务器 MBX1 中添加邮箱数据库 DB2 的副本。重播延迟时间和截断延迟时间保持为默认值 0，激活首选项的值配置为 3。

示例 3

Add-MailboxDatabaseCopy -Identity DB3 -MailboxServer MBX4 -ActivationPreference 5 -SeedingPostponed

本示例向邮箱服务器 MBX4 中添加邮箱数据库 DB3 的副本。重播延迟时间和截断延迟时间保留为默认值零，激活首选项配置为值 5。另外，还推迟了对此副本进行种子设定，以便可以使用本地源服务器（而不是当前处于活动状态且距离 MBX4 很远的数据库副本）对此副本进行种子设定。

参数

-ActivationPreference

ActivationPreference 参数值用作活动管理器最佳副本选择过程的一部分，且在使用 RedistributeActiveDatabases.ps1 脚本时用于在 DAG 中重新分布主动邮箱数据库。激活首选项的值为等于或大于 1 的数字，1 表示优先顺序最高。首选项编号不能大于邮箱数据库的副本数。

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConfigurationOnly

ConfigurationOnly 开关允许在不调用自动种子设定的情况下添加数据库副本。不必为此开关指定值。

使用此参数时，源数据库不需要为联机或存在状态。它将在 Active Directory 中创建一个新的数据库，不需要与目标服务器联系。如果目标服务器停机以进行维护且目标服务器上不存在新的数据库副本，此参数可能非常有用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

Identity 参数指定要复制的邮箱数据库。可以使用任何能够唯一标识此数据库的值。例如：

名称
可分辨名称 (DN)
GUID

类型:	DatabaseIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MailboxServer

MailboxServer 参数指定将托管数据库副本的服务器的名称。此服务器必须是同一 DAG 的成员，并且不得已托管数据库的副本。

类型:	MailboxServerIdParameter
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ReplayLagMaxDelay

ReplayLagMaxDelay 参数指定滞后数据库副本播放 (也称为延迟延迟复制淡化) 的最大延迟。如果磁盘读取 IO 延迟大于 25 毫秒，滞后的复制播放将延迟到此参数的值。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

默认值为 24：00：00 (24 小时) 。若要禁用延迟延迟副本播放，请指定值 00：00：00。

请注意，当磁盘空间不足时，将忽略此参数的值，并且延迟复制会立即播放。

类型:	EnhancedTimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReplayLagTime

ReplayLagTime 参数指定Microsoft Exchange 复制服务在重播已复制到数据库副本的日志文件之前等待的时间。

若要指定值，请以时间跨度格式 dd.hh:mm:ss 输入值（其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒）。

默认值为 00.00:00:00，指定没有截断延迟。最大值为 14.00：00：00 (14 天) 。

类型:	EnhancedTimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SeedingPostponed

SeedingPostponed 开关指定任务不为数据库副本设定种子，因此需要显式为数据库副本设定种子。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TruncationLagTime

TruncationLagTime 参数指定Microsoft Exchange 复制服务在截断重播到数据库副本的日志文件之前等待的时间。此时段是从日志成功地重播到数据库副本中后开始的。