Remove-CsExUmContact
上一次修改主题： 2012-03-25
从托管 Exchange 统一消息 (UM) 中删除自动助理或订阅者访问联系人对象。
语法
Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 与 Exchange UM 结合使用以提供一些与语音相关的功能，包括自动助理和订阅者访问。以托管服务（而不是内部部署）的形式提供 Exchange UM 时，必须使用 Windows PowerShell 创建联系人对象以便应用自动助理和订阅者访问功能。创建的任何对象都可以使用 Remove-CsExUmContact cmdlet 删除。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsExUmContact cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsExUmContact"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
UserIdParameter |
要删除的联系人对象的唯一标识符。可以采用下列四种格式之一来指定联系人标识：1) 联系人的 SIP 地址；2) 联系人的用户主体名称 (UPN)；3) 联系人的域名和登录名，格式为“域名\登录名”（如 litwareinc\exum1）；以及 4) 联系人的 Active Directory 显示名称（如 Team Auto Attendant）。 完整数据类型：Microsoft.Rtc.Management.AD.UserIdParameter |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 对象。接受通过管道传递的 Exchange UM 联系人对象的输入。
返回类型
此 cmdlet 不会返回对象。它可删除一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com
此示例删除 SIP 地址为 exumsa1@fabrikam.com 的 Exchange UM 联系人。
-------------------------- 示例 2 --------------------------
Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact
此示例删除 LineURI 值以 425 开头的所有 Exchange UM 联系人。此命令的第一部分调用带有 Filter 参数的 Get-CsExUmContact cmdlet，使用以下表达式作为筛选器：LineURI -like "tel:425*"。该筛选器指定要检索具有与通配符字符串 425\* 匹配的 LineURI 的 Exchange UM 联系人对象。换句话说，就是所有以字符串 425 开头并以任意字符集结尾的线路 URI。拥有该对象集合后，将该集合通过管道传递到 Remove-CsExUmContact cmdlet，该 cmdlet 会删除集合中的所有项。