Move-CsLegacyUser
上一次修改主题： 2012-05-21
将一个或多个用户帐户从 Microsoft Office Communications Server 2007 R2 或 Microsoft Office Communications Server 2007 迁移到 Microsoft Lync Server 2010。
语法
Move-CsLegacyUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExcludeArchivingPolicy <SwitchParameter>] [-ExcludeConferencingPolicy <SwitchParameter>] [-ExcludeDialPlan <SwitchParameter>] [-ExcludeExternalAccessPolicy <SwitchParameter>] [-ExcludePresencePolicy <SwitchParameter>] [-ExcludeVoicePolicy <SwitchParameter>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
详细说明
许多安装了 Lync Server 2010 的组织也运行该软件的早期版本（Office Communications Server 2007 R2 或 Office Communications Server 2007）。幸运的是，这不会带来问题：您可以同时运行该软件的最新版本和早期版本。随着时间的推移，您可以开始将您的配置设置、策略，最后是用户帐户迁移到 Lync Server 2010。
通过 Move-CsLegacyUser cmdlet，您不仅可以将用户迁移到 Lync Server 2010，还可以很好地控制迁移过程。例如，在最简单形式的 Move-CsLegacyUser 中，您可以提供要迁移的用户的标识和要托管用户帐户的 Lync Server 2010 注册器池的完全限定域名 (FQDN)。接下来，Move-CsLegacyUser 将移动用户帐户，并保留已应用于该帐户的任何现有的策略和设置。例如，假设在 Office Communications Server 中为 Ken Myer 分配了拨号计划。默认情况下，当您迁移 Ken 的帐户时，也将迁移拨号计划：这意味着，Move-CsLegacyUser 将自动为 Ken Myer 分配在 Communications Server 2007 R2 中已为其分配的拨号计划的 Lync Server 2010 等效计划。
当然，前提是已迁移拨号计划，并且存在 Communications Server 2007 R2 中分配给 Ken Myer 的拨号计划的 Lync Server 2010 等效计划。此外，您可能选择安装 Lync Server 2010，但不迁移拨号计划。在这种情况下，您可以调用带有 ExcludeDialPlan 参数的 Move-CsLegacyUser。使用此参数时，拨号计划将不会随用户帐户一起迁移：这意味着，Ken Myer 的用户帐户将移至 Lync Server 2010，但不会为其分配拨号计划。（即使您迁移了拨号计划也将如此，ExcludeDialPlan 参数可阻止向迁移的用户帐户分配拨号计划。）迁移用户帐户时，其他参数使您可以排除语音策略、会议策略、存档策略、外部访问策略和/或状态策略。
必须首先安装 Windows Management Instrumentation (WMI) Backward Compatibility 接口包，然后才能运行 Merge-CsLegacyTopology；可通过运行 OCSWMIBC.msi（OCSWMIBC.msi 位于安装 DVD 上的 Setup 文件夹中）安装该应用程序。安装 Compatibility 接口包之后，才能调用 Merge-CsLegacyUser，以便将一个或多个用户帐户从 Communications Server 2007 R2 或 Communications Server 2007 移动到 Lync Server 2010。
如果需要将用户从 Lync Server 移动回 Office Communications Server，请不要使用 Move-CsLegacyUser cmdlet。请改用 Move-CsUser cmdlet，并将旧版 Office Communications Server 池的 FQDN 用作 Move-CsUser 的 Target 参数的参数值。例如：
Move-CsUser –Identity "Ken Myer" –Target "ocs13.litwareinc.com"
谁可以运行此 cmdlet？默认情况下，以下各组的成员有权在本地运行 Move-CsLegacyUser cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsLegacyUser"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
指示要迁移的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 域服务显示名称（例如 Ken Myer）。此外，还可以使用用户的 Active Directory 可分辨名称引用用户标识。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，Identity "* Smith" 将返回显示名称以字符串值“ Smith”结尾的所有用户。 |
|
Target |
必需 |
字符串 |
用于托管用户帐户的注册器池的 FQDN。例如：-Target atl-cs-001.litwareinc.com。 |
DomainController |
可选 |
字符串 |
使您可以连接到指定的域控制器，以便移动用户帐户。要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机名称（例如 atl-cs-001）或其 FQDN（例如 atl-cs-001.litwareinc.com）。 |
ExcludeArchivingPolicy |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何存档策略。 |
ExcludeConferencingPolicy |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何会议策略。 |
ExcludeDialPlan |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何拨号计划。 |
ExcludeExternalAccessPolicy |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何外部访问策略。 |
ExcludePresencePolicy |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何状态策略。 |
ExcludeVoicePolicy |
可选 |
开关参数 |
如果存在，当迁移用户帐户时，将不会保留分配给该用户帐户的任何语音策略。 |
ProxyPool |
可选 |
字符串 |
此参数仅用于 Microsoft Lync Online 2010。不应将其与 Lync Server 的内部部署实现结合使用。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
PassThru |
可选 |
开关参数 |
使您可以通过管道传递用户对象（代表要移动的用户帐户）。默认情况下，Move-CsLegacyUser cmdlet 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Move-CsLegacyUser 不接受通过管道传递的输入。
返回类型
Move-CsLegacyUser 不返回任何值或对象。此 cmdlet 会移动 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
在上述示例中，使用 Move-CsLegacyUser 将 Identity 为 Pilar Ackerman 的用户帐户迁移到注册器池 atl-cs-001.litwareinc。由于不包含其他参数，因此，也将迁移先前分配给该帐户的任何策略或设置。这意味着，如果已将旧版策略（如拨号计划）分配给 Pilar Ackerman，则会在移动其帐户时向其分配 Lync Server 2010 等效策略。
-------------------------- 示例 2 --------------------------
Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -ExcludeDialPlan
示例 2 中显示的命令迁移 Pilar Ackerman 的用户帐户，但不迁移先前分配给该帐户的任何拨号计划。迁移该帐户后，Pilar 将没有分配的拨号计划。
-------------------------- 示例 3 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"
在示例 3 中，Finance OU 中的所有用户帐户将移至 Lync Server 注册器池 atl-cs-001.litwareinc.com。为完成此任务，此命令首先使用 Get-CsUser 和 OU 参数检索 Finance OU 中所有用户帐户的集合。对帐户进行检索后，将该集合通过管道传递到 Move-CsLegacyUser，后者会将每个帐户移动到新的注册器池。此命令假定 Finance OU 中的所有用户都是旧版用户。
-------------------------- 示例 4 --------------------------
Get-CsUser -UnassignedUser | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"
在上述示例中，使用 Move-CsLegacyUser 将注册器池分配给所有已启用 Lync Server 但尚未分配到注册器池的用户。在此命令中，调用带有 UnassignedUser 参数的 Get-CsUser cmdlet，返回当前未分配给注册器池的所有用户的集合。然后将此集合通过管道传递到 Move-CsLegacyUser，后者将每个用户分配给 atl-cs-001.litwareinc.com。此示例假定所有未分配用户都是旧版用户。