Set-CsUserReplicatorConfiguration
上一次修改主题： 2012-03-25
修改现有的用户复制程序配置设置集合。用户复制程序定期从 Active Directory 域服务 (AD DS) 中检索最新用户帐户信息，然后将新信息与 Microsoft Lync Server 2010 存储的最新用户数据同步。
语法
Set-CsUserReplicatorConfiguration [-Identity <XdsIdentity>] [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsUserReplicatorConfiguration [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]
详细说明
虽然 Lync Server 2010 维护其自己的用户帐户和用户帐户数据的数据库，但是 Lync Server 2010 仍依赖于 AD DS，并将其作为用户信息的最终来源。例如，当创建新的 Active Directory 用户帐户时，必须提供有关用户帐户的基本信息（如 Active Directory 显示名称）。但是，如果用户启用了 Lync Server，则无需指定新的显示名称。这是因为 Lync Server 使用已存储在 AD DS 中的显示名称。
用户帐号信息（包括 Active Directory 显示名称）会随着时间推移而发生更改。例如，已婚用户可能会更改其姓氏，相应地，将需要更改其显示名称。为了确保 Lync Server 数据库与 AD DS 保持同步，Lync Server 必须定期检查 AD DS，检索最新的用户帐户更新，并相应修改 Lync Server 用户数据库。AD DS 与 Lync Server 之间的同步由用户复制程序执行。
安装 Lync Server 时，系统将为您创建一组全局用户复制程序配置设置。默认情况下，这些设置用于在组织范围内管理用户复制程序。管理用户复制程序包括标识需要与 Lync Server 同步的域，以及指示用户复制程序检查 AD DS 中的用户帐户更新的频率。默认情况下，用户复制程序会发现所有可用域并与其同步。但是，使用 AdDomainNamingContextList 属性可以将同步限制为一组特定的域：显示在 AdDomainNamingContextList 属性中的域。
您也可以在 service 作用域创建其他集合，但仅当您使用的是 Microsoft Lync Online 2010 时，才能创建其他集合。
Set-CsUserReplicatorConfiguration cmdlet 用于修改组织中当前使用的任何用户复制程序设置。您可以使用此 cmdlet 在必须与用户复制程序保持同步的域列表中添加或删除域，以及修改复制周期之间的时间间隔。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsUserReplicatorConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有 RBAC 角色的列表（包括您自己创建的任何基于自定义角色的访问控制 (RBAC) 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserReplicatorConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的用户复制程序配置设置的唯一标识符。要修改全局设置，请使用以下语法：-Identity global。 |
Instance |
可选 |
UserReplicatorConfiguration 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
ADDomainNamingContextList |
可选 |
PS 列表修饰符 |
必须与用户复制程序保持同步的 Active Directory 域的可分辨名称。例如，要向列表中添加域，请使用以下类似语法： -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"} 如果将此属性设置为空值，用户复制程序会发现所有可用域并与其同步。如果此属性不是空值，用户复制程序将只与 ADDomainNamingContextList 中指定的域同步。 |
ReplicationCycleInterval |
可选 |
TimeSpan |
表示用户复制程序在检查 AD DS 中的用户帐户更新之前等待的时间。复制周期间隔可以是介于 1 秒到 23 小时 59 分 59 秒之间的任意时间值；默认值为 1 分钟。该间隔必须使用 hours:minutes:seconds 格式表示。例如，以下语法将时间间隔设置为 1 小时 15 分钟： -ReplicationCycleInterval 01:15:00 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration 对象。Set-CsUserReplicatorConfiguration 接受通过管道传递的用户复制程序配置对象的输入。
返回类型
Set-CsUserReplicatorConfiguration 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration 对象的全局实例（唯一实例）。
示例
-------------------------- 示例 1 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ReplicationCycleInterval "00:05:00"
上述命令将全局用户复制程序设置的 ReplicationCycleInterval 值设置为 5 分钟（00 小时:05 分钟:00 秒）的设置。
-------------------------- 示例 2 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null
示例 2 中显示的命令清除 ADDomainNamingContextList 属性的值。此任务是通过包含 ADDomainNamingContextList 参数并将参数值设置为空来实现的。通过将此值设置为空，用户复制程序会自动发现所有可用域并与其同步。
-------------------------- 示例 3 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}
在示例 3 中，向全局用户复制程序设置的 ADDomainNamingContextList 属性添加其他名称。为此，使用了语法 @{Add=} 和要添加的域的可分辨名称。运行此命令之后，将向域名列表添加 fabrikam.com。要配置全局设置以使该列表仅包含 fabrikam.com，请使用以下语法：
-ADDomainNamingContextList @{Replace="dc=fabrikam,dc=com"}
如果将 AdDomainNamingContextList 属性设置为任何非空值，用户复制程序会仅与该属性值中列出的域同步，即使部署中还有其他域也是如此。
-------------------------- 示例 4 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Remove="dc=fabrikam,dc=com"}
示例 4 从全局用户复制程序配置设置的 ADDomainNamingContextList 属性中删除域 fabrikam.com。为执行此操作，使用了语法 @{Remove=} 和域 (dc=fabrikam,dc=com) 的可分辨名称 (DN)。