[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Returns information about the dial plans used in your organization.

Syntax

Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]

Parameters

Parameter Required Type Description

Identity

Optional

XdsIdentity

The unique identifier designating the scope, and for per-user scope, a name, to identify the dial plan you want to retrieve.

Filter

Optional

String

Performs a wildcard search that allows you to narrow down your results to only dial plans with scopes that match the given wildcard string.

LocalStore

Optional

SwitchParameter

Retrieves the dial plan information from the local replica of the Central Management database, rather than the Central Management database itself.

Detailed Description

This cmdlet returns information about one or more dial plans (also known as a location profiles) in an organization. Dial plans provide information required to enable Enterprise Voice users to make telephone calls. Dial plans are also used by the Conferencing Attendant application for dial-in conferencing. What a dial plan determines includes which normalization rules are applied and whether a prefix must be dialed for external calls.

Note: You can use Get-CsDialPlan to retrieve specific information about the normalization rules of a dial plan, but if that’s the only dial plan information you need, you can also use the Get-CsVoiceNormalizationRule cmdlet.

Return Types

This cmdlet returns instances of the Microsoft.Rtc.Management.WriteableConfig.Policy.Voice.LocationProfile object.

Examples

-------------------------- Example 1 --------------------------

Copy Code
Get-CsDialPlan

Example 1 returns a collection of all the dial plans configured for use in your organization by calling Get-CsDialPlan without any additional parameters.

-------------------------- Example 2 --------------------------

Copy Code
Get-CsDialPlan -Identity RedmondDialPlan

In Example 2, the Identity parameter is used to limit the retrieved data to dial plans that have a per-user dial plan with the Identity RedmondDialPlan. Because identities must be unique, this command will return only the specified dial plan.

-------------------------- Example 3 --------------------------

Copy Code
Get-CsDialPlan -Identity site:Redmond

Example 3 is identical to Example 2 except that instead of retrieving a per-user dial plan, we’re retrieving a dial plan assigned to a site. We do that by specifying the value site: followed by the site name (in this case Redmond) of the site we want to retrieve.

-------------------------- Example 4 --------------------------

Copy Code
Get-CsDialPlan -Filter tag:*

This example uses the Filter parameter to return a collection of all the dial plans that have been configured at the per-user scope. (Settings configured at the per-user, or tag, scope can be directly assigned to users and groups.) The wildcard tag:* instructs PowerShell to return only those dial plans that have an identity beginning with the string value tag:, which identifies a dial plan as a per-user dial plan.

-------------------------- Example 5 --------------------------

Copy Code
Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

This example displays the normalization rules used by the dial plans configured for use in your organization. Because the NormalizationRules property consists of an array of objects, the complete set of normalization rules is typically not displayed on screen. To see all of these rules, this sample command first uses Get-CsDialPlan to retrieve a collection of all the dial plans. That collection is then piped to the Select-Object cmdlet; in turn, the ExpandProperty parameter of Select-Object is used to expand the values found in the NormalizationRules property. Expanding the values simply means that all the normalization rules will be displayed on the screen.

-------------------------- Example 6 --------------------------

Copy Code
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}

In Example 5, Get-CsDialPlan and Where-Object are used to retrieve a collection of all the dial plans that include the word Redmond in their description. To do this, the command first uses Get-CsDialPlan to retrieve all the dial plans. That collection is then piped to Where-Object, which applies a filter that limits the returned data to profiles that have the word Redmond somewhere in their Description.