Add-MailboxDatabaseCopy
此 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 表示优先顺序最高。 首选项编号不能大于邮箱数据库的副本数。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConfigurationOnly
ConfigurationOnly 开关允许在不调用自动种子设定的情况下添加数据库副本。 不必为此开关指定值。
使用此参数时,源数据库不需要为联机或存在状态。 它将在 Active Directory 中创建一个新的数据库,不需要与目标服务器联系。 如果目标服务器停机以进行维护且目标服务器上不存在新的数据库副本,此参数可能非常有用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定要复制的邮箱数据库。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
Type: | DatabaseIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxServer
MailboxServer 参数指定将托管数据库副本的服务器的名称。 此服务器必须是同一 DAG 的成员,并且不得已托管数据库的副本。
Type: | MailboxServerIdParameter |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReplayLagMaxDelay
ReplayLagMaxDelay 参数指定滞后数据库副本播放 (也称为延迟延迟复制淡化) 的最大延迟。 如果磁盘读取 IO 延迟大于 25 毫秒,滞后的复制播放将延迟到此参数的值。
若要指定值,请将其输入为时间跨度:dd.hh:mm:ss,其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒。
默认值为 24:00:00 (24 小时) 。 若要禁用延迟延迟副本播放,请指定值 00:00:00。
请注意,当磁盘空间不足时,将忽略此参数的值,并且延迟复制会立即播放。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-ReplayLagTime
ReplayLagTime 参数指定Microsoft Exchange 复制服务在重播已复制到数据库副本的日志文件之前等待的时间。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
默认值为 00.00:00:00,指定没有截断延迟。 最大值为 14.00:00:00 (14 天) 。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SeedingPostponed
SeedingPostponed 开关指定任务不为数据库副本设定种子,因此需要显式为数据库副本设定种子。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TruncationLagTime
TruncationLagTime 参数指定Microsoft Exchange 复制服务在截断重播到数据库副本的日志文件之前等待的时间。 此时段是从日志成功地重播到数据库副本中后开始的。
若要指定值,请将其输入为时间跨度:dd.hh:mm:ss,其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒。
默认值为 00.00:00:00,指定没有截断延迟。 最大值为 14.00:00:00 (14 天) 。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。