Set-CsDialPlan

Syntax

Set-CsDialPlan
   [[-Identity] <XdsIdentity>]
   [-Description <String>]
   [-DialinConferencingRegion <String>]
   [-ExternalAccessPrefix <String>]
   [-NormalizationRules <PSListModifier>]
   [-OptimizeDeviceDialing <Boolean>]
   [-SimpleName <String>]
   [-State <String>]
   [-City <String>]
   [-CountryCode <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CsDialPlan
   [-Instance <PSObject>]
   [-Description <String>]
   [-DialinConferencingRegion <String>]
   [-ExternalAccessPrefix <String>]
   [-NormalizationRules <PSListModifier>]
   [-OptimizeDeviceDialing <Boolean>]
   [-SimpleName <String>]
   [-State <String>]
   [-City <String>]
   [-CountryCode <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

This cmdlet modifies an existing dial plan (also known as a location profile). 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. A dial plan determines such things as which normalization rules are applied and whether a prefix must be dialed for external calls.

Note: While normalization rules of a dial plan can be modified with this cmdlet, it is recommended that the New-CsVoiceNormalizationRule cmdlet, the Set-CsVoiceNormalizationRule cmdlet, or the Remove-CsVoiceNormalizationRule cmdlet be used instead. The changes made with those cmdlets will be reflected in the corresponding dial plan.

Examples

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

Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."

In Example 1, the Set-CsDialPlan cmdlet is used to modify the dial plan with the Identity RedmondDialPlan. In this case, the only property being modified is the Description; this modification is performed by specifying the Description parameter followed by the text for the new description.

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

Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8

In this example, the Set-CsDialPlan cmdlet is used to change the value of the ExternalAccessPrefix property for all the dial plans configured for use in the organization. To do this, the command first uses the Get-CsDialPlan cmdlet to return a collection of all the dial plans in the organization. That collection is then piped to the Set-CsDialPlan cmdlet, which assigns the value 8 to the ExternalAccessPrefix property for each profile in the collection.

Parameters

-City

-Confirm

-CountryCode

-Description

-DialinConferencingRegion

-ExternalAccessPrefix

-Force

-Identity

-Instance

-NormalizationRules

-OptimizeDeviceDialing

-SimpleName

-State

-WhatIf

Inputs

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile object. Accepts pipelined input of dial plan objects.

Outputs

The Set-CsDialPlan cmdlet does not return a value or object. Instead, the cmdlet configures instances of the Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile object.

Related Links

• New-CsDialPlan
• Remove-CsDialPlan
• Get-CsDialPlan
• Grant-CsDialPlan
• Test-CsDialPlan
• New-CsVoiceNormalizationRule
• Set-CsVoiceNormalizationRule
• Remove-CsVoiceNormalizationRule
• Get-CsVoiceNormalizationRule