Get-CsDialPlan
上一次修改主题： 2012-03-23
返回有关您组织中使用的拨号计划的信息。
语法
Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
此 cmdlet 可返回有关组织中的一个或多个拨号计划（也称为位置配置文件）的信息。拨号计划提供了企业语音用户进行电话呼叫时所需的信息。拨号计划也可由 会议助理应用程序 用于实现电话拨入式会议功能。拨号计划可确定要应用哪些规范化规则，以及在进行外部呼叫时是否必须拨打前缀号码等内容。
注意：可以使用 Get-CsDialPlan 来检索有关拨号计划的规范化规则的特定信息，但是如果这是您需要的唯一拨号计划信息，则还可以使用 Get-CsVoiceNormalizationRule cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsDialPlan cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialPlan"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
用于指定作用域（对于每用户作用域，则用于指定名称）以标识要检索的拨号计划的唯一标识符。 |
Filter |
可选 |
字符串 |
执行通配符搜索，该搜索允许您将结果限制为标识与给定通配符字符串匹配的拨号计划。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索拨号计划信息。 |
输入类型
无。
返回类型
此 cmdlet 返回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsDialPlan
示例 1 返回配置为在组织中使用的所有拨号计划的集合，这是通过调用不带其他任何参数的 Get-CsDialPlan 实现的。
-------------------------- 示例 2 --------------------------
Get-CsDialPlan -Identity RedmondDialPlan
在示例 2 中，Identity 参数用于将检索到的数据限制为具有 Identity 为 RedmondDialPlan 的每用户拨号计划的拨号计划。由于标识必须唯一，因此此命令将仅返回指定的拨号计划。
-------------------------- 示例 3 --------------------------
Get-CsDialPlan -Identity site:Redmond
示例 3 与示例 2 几乎相同，只是在此示例中我们检索分配给站点的拨号计划，而不是检索每用户拨号计划。这是通过指定值 site: 后跟要检索的站点的站点名称（此示例中为 Redmond）来实现的。
-------------------------- 示例 4 --------------------------
Get-CsDialPlan -Filter tag:*
此示例使用 Filter 参数返回在每用户作用域配置的所有拨号计划的集合。（可以将在每用户作用域或 tag 作用域配置的设置直接分配给用户和组。）通配符字符串 tag:* 指示 cmdlet 仅返回标识以字符串值 tag: 开头的拨号计划，其中 tag: 将拨号计划标识为每用户拨号计划。
-------------------------- 示例 5 --------------------------
Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules
此示例显示配置为在组织中使用的拨号计划所使用的规范化规则。由于 NormalizationRules 属性由对象数组组成，因此通常不会在屏幕上显示完整的规范化规则集。为了查看所有这些规则，此示例命令首先使用 Get-CsDialPlan 检索所有拨号计划的集合。然后将此集合通过管道传递到 Select-Object cmdlet，Select-Object 的 ExpandProperty 参数用于“展开”NormalizationRules 属性中的值。展开值仅意味着所有规范化规则都将逐个列在屏幕上，与调用 Get-CsVoiceNormalizationRule 时显示的输出相同。
-------------------------- 示例 6 --------------------------
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}
在示例 6 中，使用 Get-CsDialPlan 和 Where-Object 检索描述中包含单词 Redmond 的所有拨号计划的集合。为执行此操作，该命令首先使用 Get-CsDialPlan 检索所有拨号计划。然后将该集合通过管道传递到 Where-Object，后者应用筛选器，将返回的数据限制为描述中包含单词 Redmond 的配置文件。