Remove-CsCommonAreaPhone
上一次修改主题： 2012-03-27
从使用 Microsoft Lync Server 2010 管理的电话集合中删除现有的公用区域电话。公用区域电话是指位于建筑物大厅、员工休息室或其他可能由多人使用的区域，并供许多不同用户使用的电话。
语法
Remove-CsCommonAreaPhone [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]
详细说明
公用区域电话是不与个别用户关联的 IP 电话，通常不是位于某人的办公室，而是位于建筑物大厅、餐厅、员工休息室、会议室和其他可能有大量人员聚集的位置。这为管理员的管理工作带来了挑战，因为 Lync Server 2010 中的电话使用通常是使用分配给个别用户的语音策略和拨号计划维护。不会为公用区域电话分配个别用户。
此问题的解决方案之一是为所有公用区域电话创建 Active Directory 联系人对象。（可以使用 New-CsCommonAreaPhone cmdlet 来创建这些联系人对象。）与用户帐户相同，可以为这些联系人对象分配策略和语音计划。这样，即使公用区域电话未与个别用户关联，也可以控制这些电话。例如，如果您不希望用户能够转接或驻留来自公用区域电话的呼叫，可以创建禁止呼叫转接和呼叫驻留的语音策略，然后将该策略分配给公用区域电话。（更准确地说，分配给代表公用区域电话的联系人对象。）例如，此命令可将语音策略 CommonAreaPhoneVoicePolicy 分配给所有公用区域电话：
Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"
有时可能需要删除与公用区域电话关联的联系人对象。例如，如果删除员工休息室的电话，则不再需要与该电话关联的联系人对象。Remove-CsCommonAreaPhone cmdlet 提供了一种删除公用区域电话的方法。运行此 cmdlet 时，将从 Get-CsCommonAreaPhone 返回的公用区域电话列表中删除该电话。此外，也将从 Active Directory 域服务 (AD DS) 中删除与该电话关联的联系人对象。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsCommonAreaPhone cmdlet：RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission cmdlet 分配针对特定站点或特定 Active Directory 组织单位 (OU) 运行此 cmdlet 的权限。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCommonAreaPhone"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 ID 参数 |
公用区域电话的唯一标识符。使用相关联系人对象的 Active Directory 可分辨名称标识公用区域电话。默认情况下，公用区域电话使用全局唯一标识符 (GUID) 作为其公用名，这意味着电话通常会具有类似如下的标识：CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。由此可知，使用 Get-CsCommonAreaPhone cmdlet，然后将返回的对象通过管道传递到 Remove-CsCommonAreaPhone，更便于检索公用区域电话。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 对象。Remove-CsCommonAreaPhone 接受通过管道传递的公用区域电话对象的实例。
返回类型
Remove-CsCommonAreaPhone 删除 Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"} | Remove-CsCommonAreaPhone
示例 1 中显示的命令删除显示名称为“Building 14 Lobby”的公用区域电话。为执行此操作，该命令首先调用带有 Filter 参数且筛选器值为“{DisplayName -eq "Building 14 Lobby"}”的 Get-CsCommonAreaPhone。然后，将返回的对象通过管道传递到 Remove-CsCommonAreaPhone cmdlet，并由其删除。
-------------------------- 示例 2 --------------------------
Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null} | Remove-CsCommonAreaPhone
在示例 2 中，此命令删除所有未分配拨号计划的公用区域电话。为完成此任务，首先使用 Get-CsCommonAreaPhone 和 Filter 参数返回指定的项，筛选器值 {DialPlan -eq $Null} 将返回数据限制为未分配拨号计划的公用区域电话。然后，将筛选出的集合通过管道传递到 Remove-CsCommonAreaPhone，后者将删除集合中的每个电话。
-------------------------- 示例 3 --------------------------
Get-CsCommonAreaPhone -OU "ou=Redmond,dc=litwareinc,dc=com" | Remove-CsCommonAreaPhone
示例 3 删除联系人对象位于 Active Directory 的 Redmond OU 中的所有公用区域电话。为完成此任务，首先调用 Get-CsCommonAreaPhone 以返回联系人对象位于 Redmond OU 中的所有公用区域电话，OU 参数和参数值“ou=Redmond,dc=litwareinc,dc=com”用于将返回数据限制为指定的组织单位。然后，将返回的集合通过管道传递到 Remove-CsCommonAreaPhone，后者将删除该集合中的每一个电话。