Move-CsExUmContact
上一次修改主题： 2012-03-23
将一个或多个 Exchange 统一消息 (UM) 联系人移至新的注册器池。
语法
Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 与 Exchange UM 结合使用以提供一些与语音相关的功能，包括自动助理和订阅者访问。Move-CsExUmContact 提供了一种将现有 Exchange UM 联系人对象移至新注册器池的方法。可以将联系人对象从 Microsoft Office Communications Server 2007 或 Microsoft Office Communications Server 2007 R2 池移至 Lync Server 2010 池，或从一个 Lync Server 2010 池移至另一个池。此 cmdlet 不会将 Exchange UM 联系人对象从 Lync Server 2010 池移至 Office Communications Server 2007 或 Office Communications Server 2007 R2 池。
当移动 Exchange UM 联系人对象时，会根据该对象的 OtherIpPhone 属性的值相应地设置 AutoAttendant 和 IsSubscriberAccess 属性。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Move-CsExUmContact cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsExUmContact"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
UserIdParameter |
要移动的联系人对象的唯一标识符。可以采用下列四种格式之一来指定联系人标识：1) 联系人的 SIP 地址；2) 联系人的用户主体名称 (UPN)；3) 联系人的域名和登录名，格式为“域名\登录名”（如 litwareinc\exum1）；以及 4) 联系人的 Active Directory 显示名称（例如 Team Auto Attendant）。 |
Target |
必需 |
Fqdn |
要将联系人移至的注册器池的完全限定域名 (FQDN)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
DomainController |
可选 |
Fqdn |
使您可以连接到指定的域控制器。若要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机名称（例如 atl-mcs-001）或其 FQDN（例如 atl-mcs-001.litwareinc.com）。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
PassThru |
可选 |
开关参数 |
使您可以通过管道传递联系人对象（代表要移动的联系人帐户）。默认情况下，此 Move-CsExUmContact cmdlet 不会通过管道传递对象。 |
ProxyPool |
可选 |
Fqdn |
此参数仅用于 Lync Server 的托管实例。不应将其与 Lync Server 的内部部署实现结合使用。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
输入类型
字符串。接受通过管道传递的字符串值，代表要移动的 Exchange UM 对象的标识。
返回类型
如果调用时带有 PassThru 参数，则将返回一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com
示例 1 将 SIP 地址为 exum1@fabrikam.com 的 Exchange UM 联系人对象移至 FQDN 为 atl-cs-001.litwareinc.com 的注册器池。请注意，运行此命令时将会显示确认提示，尽管未包含 Confirm 参数。即使包含 Force 参数，也会显示该提示。
-------------------------- 示例 2 --------------------------
Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com
此示例将作为自动助理的所有 Exchange UM 联系人对象移至 FQDN 为 atl-cs-001.litwareinc.com 的注册器池。此示例首先调用 Get-CsExUmContact，后者将检索已定义的所有 Exchange UM 联系人。然后，将该联系人集合通过管道传递到 Where-Object cmdlet，后者会查找集合中 AutoAttendant 属性值为 True ($True)（表示该联系人为自动助理）的所有联系人。
最后，将 AutoAttendant 为 True 的联系人集合通过管道传递到 Move-CsExUmContact cmdlet，后者会将这些联系人移至 Target 参数中指定的注册器池。
与示例 1 中一样，运行此命令时，系统将会提示您确认。