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