Commands › Microsoft Teams

Set-CsTenantDialPlan

Microsoft Teams MicrosoftTeams Set-*

Modify an existing tenant dial plan.

Quick start script

# Set-CsTenantDialPlan — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTenantDialPlan
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTenantDialPlan  -WhatIf
Set-CsTenantDialPlan

# 4. Verify and diff
$after = Get-CsTenantDialPlan
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-CsTenantDialPlan [[-Identity] <string>] [-Description <string>] [-NormalizationRules <Object>]
 [-SimpleName <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (6)

Parameter	Type	What it controls
-Confirm	SwitchParameter	The Confirm switch causes the command to pause processing and requires confirmation to proceed.
-Description	String	The Description parameter describes the tenant dial plan - what it's for, what type of user it applies to or any other information that helps to identify the purpose of the tenant dial plan. Maximum characters is 1040.
-Identity	String	The Identity parameter is a unique identifier that designates the name of the tenant dial plan to modify.
-NormalizationRules	List	The NormalizationRules parameter is a list of normalization rules that are applied to this dial plan. Although this list and these rules can be created directly by using this cmdlet, we recommend that you create the...
-SimpleName	String	The SimpleName parameter is a display name for the tenant dial plan. This name must be unique among all tenant dial plans.
-WhatIf	SwitchParameter	The WhatIf parameter describes what would happen if you executed the command, without actually executing the command.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.