Remove-CsUserAcp
上一次修改主题： 2012-03-25
删除分配给用户或用户组的一个或多个音频会议提供商。
语法
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <String>] [-WhatIf [<SwitchParameter>]]
详细说明
音频会议提供商是为组织提供会议服务的第三方公司。音频会议提供商的功能之一是为外出且未连接到企业网络或 Internet 的用户提供了一种通过音频参加会议的方法。音频会议提供商通常会提供一些高端服务，如实时翻译、转录和每个会议的实时接线员协助。
Microsoft Lync Server 2010 不允许与音频会议提供商完全集成。通过 CsUserAcp cmdlet，管理员可以设置电话号码和密码，以及配置每次用户安排会议时都可用于音频会议提供商集成的其他信息。但是，由于这些 cmdlet 并非旨在用于 Lync Server 的内部版本（而是主要用于与 Microsoft Lync Online 2010 配合使用），因此除分配属性值外，未提供其他音频会议提供商集成。
分配给用户的任何音频会议提供商都可以在稍后使用 Remove-CsUserAcp cmdlet 删除。调用不带任何参数（指示要修改的用户帐户的 Identity 参数除外）的 Remove-CsUserAcp 可删除分配给用户的所有音频会议提供商。此外，您还可以使用 Remove-CsUserAcp 中包含的可选参数从用户帐户中删除选定的提供商。例如，此命令可找出 Ken Myer 的用户帐户，并删除 Name 等于“Fabrikam ACP”的所有音频会议提供商：
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
要精确地删除音频会议提供商，只需包含其他参数。例如，以下命令可删除 Name 为“Fabrikam ACP”且 TollNumber 等于“14255551298”的任何音频会议提供商：
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsUserAcp cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserAcp"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户标识 |
指示要从中删除音频会议提供商的用户帐户的标识。可以使用以下四种格式之一指定用户的标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 域服务 (AD DS) 显示名称（例如 Ken Myer）。此外，还可以使用用户的 Active Directory 可分辨名称引用用户标识。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，Identity "* Smith" 将返回显示名称以字符串值“ Smith”结尾的所有用户。 |
Name |
可选 |
字符串 |
音频会议提供商的名称。例如：-Name "Fabrikam Conference Services"。 |
ParticipantPassCode |
可选 |
字符串 |
通过使用音频会议提供商连接到会议时所需的密码。例如：-PassCode "0712"。 |
TollNumber |
可选 |
字符串 |
用于音频会议的付费电话号码。例如：-TollNumber "14255551298"。 |
PassThru |
可选 |
开关参数 |
使您可以通过管道传递用户对象（代表已删除音频会议提供商的用户）。默认情况下，Remove-CsUserAcp cmdlet 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Remove-CsUserAcp 接受通过管道传递的字符串值，代表已启用 Microsoft Lync Server 2010 的用户帐户的标识。该 cmdlet 还接受通过管道传递的 Active Directory 用户对象的实例。
返回类型
无。
示例
-------------------------- 示例 1 --------------------------
Remove-CsUserAcp -Identity "Ken Myer"
示例 1 中显示的命令删除已分配给用户 Ken Myer 的所有音频会议提供商。
-------------------------- 示例 2 --------------------------
Get-CsUser | Remove-CsUserAcp
示例 2 说明了如何删除已分配给所有启用 Lync Server 2010 的用户的所有音频会议提供商。为执行此操作，该命令首先使用 Get-CsUser 检索已启用 Lync Server 的所有用户的集合。然后，将此集合通过管道传递到 Remove-CsUserAcp cmdlet，后者将删除已分配给集合中每个用户的所有音频会议提供商。
-------------------------- 示例 3 --------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
在示例 3 中，从 Ken Myer 的用户帐户中删除 Name 为“Fabrikam ACP”的所有音频会议提供商。
-------------------------- 示例 4 --------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
上述命令从已分配有音频会议提供商的所有用户帐户中删除收费电话号码为“14255551298”的音频会议提供商。为完成此任务，该命令首先使用 Get-CsUserAcp 返回有关分配给所有用户的所有音频会议提供商的信息。将此信息通过管道传递到 Where-Object cmdlet，该 cmdlet 将仅选择 AcpInfo 属性包含 (-match) 电话号码“14255551298”的帐户。然后，将筛选出的集合通过管道传递到 Remove-CsUserAcp cmdlet，后者从该集合的每个帐户中删除对应的音频会议提供商。