Remove-CsUnassignedNumber
上一次修改主题: 2012-03-26
删除现有的未分配的号码范围和应用于这些号码的路由规则。
语法
Remove-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
未分配的号码是指已分配给组织但尚未分配给特定用户或电话的电话号码。当呼叫未分配的号码时,可设置 Microsoft Lync Server 2010 将呼叫路由至相应目标。此 cmdlet 可删除定义该路由的设置。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsUnassignedNumber cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUnassignedNumber"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
要删除的未分配号码范围的唯一名称。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange 对象。接受通过管道传递的未分配号码对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsUnassignedNumber -Identity UNSet1
在此示例中,将删除 Identity 为 UNSet1 的未分配号码设置。
-------------------------- 示例 2 --------------------------
Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Remove-CsUnassignedNumber
示例 2 删除已分配通知的名称中包含字符串 Welcome 的所有未分配号码的设置。此命令首先调用 Get-CsUnassignedNumber,后者会返回所有未分配号码的设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会缩小集合范围,使其仅包含 AnnouncementName 含有 (-match) 字符串 Welcome 的未分配号码的设置。最后,将缩小范围的集合传递到 Remove-CsUnassignedNumber,后者会删除该集合中保留的所有内容。