Remove-CsDialPlan
上一次修改主题： 2012-03-25
删除指定的拨号计划。此 cmdlet 还可以用于删除全局拨号计划。但是，如果删除全局拨号计划，实际上并不会删除此拨号计划，而只是将设置重置为其默认值。
语法
Remove-CsDialPlan -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 可删除现有拨号计划（也称为位置配置文件）。拨号计划提供了企业语音用户进行电话呼叫时所需的信息。拨号计划也可由 会议助理应用程序 用于实现电话拨入式会议功能。拨号计划可确定要应用哪些规范化规则，以及在进行外部呼叫时是否必须拨打前缀号码等内容。
注意：删除拨号计划同时会删除所有关联的规范化规则。如果删除全局拨号计划，则还会删除所有关联的规范化规则，但是会创建一个默认的全局规范化规则。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsDialPlan cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialPlan"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的拨号计划的唯一标识符。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 对象。Remove-CsDialPlan 接受通过管道传递的拨号计划对象的输入。
返回类型
此 cmdlet 删除 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsDialPlan -Identity RedmondDialPlan
上述示例使用 Remove-CsDialPlan 删除 Identity 为 RedmondDialPlan 的每用户拨号计划。请注意，删除拨号计划时，不必为已分配了该拨号计划的用户分配新的计划。这些用户将改用分配给他们的服务或站点的拨号计划，或使用全局计划。
-------------------------- 示例 2 --------------------------
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"} | Remove-CsDialPlan
在示例 2 中，将删除描述中包含单词“Redmond”的所有拨号计划。为此，该命令首先调用 Get-CsDialPlan 以返回配置为在组织中使用的所有拨号计划的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会将应用筛选器将返回的数据限制为描述中包含单词“Redmond”的配置文件。完成之后，将筛选出的集合传递到 Remove-CsDialPlan，后者会删除集合中的所有拨号计划。