Move-CsUser
上一次修改主题： 2012-03-23
将一个或多个启用了 Microsoft Lync Server 2010 的用户帐户移至新的注册器池。
语法
Move-CsUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
详细说明
Move-CsUser cmdlet 使您能够将启用了 Lync Server 2010 的用户帐户从一个注册器池移至另一个注册器池。Move-CsUser 仅对用户的 Lync Server 帐户位置产生影响，并不会将用户的 Active Directory 帐户移至新的组织单位 (OU) 或其他新的位置。
如果 Lync Server 与 Office Communications Server 2007 R2 或 Office Communications Server 2007 共存，则 Move-CsUser cmdlet 可用于将用户从 Lync Server 移回至 Office Communications Server 的旧版安装。要将用户移回 Office Communications Server，请将旧版池的完全限定域名分配给 Target 参数。如果执行此操作，请记住，移回至 Office Communications Server 的用户将可能会遇到功能丧失和数据丢失，这是因为 Lync Server 具有的功能要比 Office Communications Server 2007 或 Office Communications Server 2007 R2 多得多。移回的用户也可能需要安装其客户端软件的以前版本，并且可能需要重新安排当其用户帐户托管在 Lync Server 上时所创建的会议。
要将用户从 Communications Server 2007 或 Communications Server 2007 R2 移至 Lync Server，请使用 Move-CsLegacyUser cmdlet。Move-CsUser 旨在将用户从一个 Lync Server 移至另一个 Lync Server 池，或将用户从 Lync Server 池移至 Office Communications Server 池。Move-CsLegacyUser 将用户从 Office Communications Server 移至 Lync Server。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Move-CsUser cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsUser"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 Id 参数 |
指示要移动的用户帐户的标识。可以使用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。此外，还可以使用用户的 Active Directory 可分辨名称引用用户标识。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，标识“* Smith”将返回显示名称以字符串值“Smith”结尾的所有用户。 |
Target |
必需 |
FQDN |
应当移动用户帐户的注册器池的 FQDN（例如，atl-cs-001.litwareinc.com）。除了注册器池以外，目标还可以是旧版 Office Communications Server 前端服务器或宿主提供商的 FQDN。移至宿主提供商的任何帐户（例如，Microsoft Lync Online 2010）均将丢失其所有关联的用户数据。例如，用户已安排的任何会议均将被删除，并且将在 Lync Online 2010 中不可用。 |
DomainController |
可选 |
字符串 |
使您可以连接到指定的域控制器，以便检索联系人信息。要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机名称（例如 atl-cs-001）或其 FQDN（例如 atl-cs-001.litwareinc.com）。 |
ProxyPool |
可选 |
字符串 |
此参数仅用于 Microsoft Lync Online 2010。不应将其与 Lync Server 的内部部署实现结合使用。 |
Force |
可选 |
开关参数 |
如果存在，则将移动用户帐户但删除所有相关用户数据（例如用户已安排的会议）。如果不存在，则将同时移动帐户和相关数据。 |
PassThru |
可选 |
开关参数 |
使您能够通过表示要移动的用户账户的管道来传递用户对象。默认情况下，此 Move-CsUser cmdlet 不会通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
使您可以绕过确认提示，否则，当您尝试移动用户时会出现该提示。要绕过确认提示，请使用以下语法来包含 Confirm 参数： -Confirm:$False 如果您想要显示确认提示，则可使用以下语法： -Confirm |
输入类型
字符串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Move-CsUser 接受通过管道传递的字符串值，代表已启用 Lync Server 的用户帐户的标识。该 cmdlet 还接受通过管道传递的 Active Directory 用户对象的实例。
返回类型
Move-CsUser 不会返回值或对象。此 cmdlet 会修改 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
在上述示例中，Move-CsUser 用于将 Identity 为 Pilar Ackerman 的用户帐户移至注册器池 atl-cs-001.litwareinc.com。
-------------------------- 示例 2 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsUser -Target "atl-cs-001.litwareinc.com"
在示例 2 中，Finance 组织单位 (OU) 中的所有用户帐户将移至注册器池 atl-cs-001.litwareinc.com。为完成此任务，此命令首先使用 Get-CsUser 和 OU 参数检索 Finance OU 中所有用户帐户的集合。数据检索完成后，将信息通过管道传递到 Move-CsUser，后者将集合中的每个帐户移至注册器池 atl-cs-001.litwareinc.com。
-------------------------- 示例 3 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -Force
在上述示例中，Move-CsUser 用于将 Identity 为 Pilar Ackerman 的用户帐户移至注册器池 atl-cs-001.litwareinc.com。此外，Force 参数用于确保仅移动帐户本身，不移动该帐户的相关用户数据（例如，有关 Pilar 预定的会议），而是丢弃这些数据。只有尝试调用不带 Force 参数的 Move-CsUser 并且该移动操作失败时，才应使用 Force 参数。