Commands › Microsoft Teams
New-CsTenantDialPlan
Create a new tenant dial plan.
Quick start script
# New-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)
New-CsTenantDialPlan -Identity <String> -WhatIf
New-CsTenantDialPlan -Identity <String>
# 4. Verify and diff
$after = Get-CsTenantDialPlan
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsTenantDialPlan [-Identity] <string> [-Description <string>] [-NormalizationRules <Object>]
[-SimpleName <string>] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (6)
| Parameter | Type | Required | 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 and any other information that helps to identify the purpose of the tenant dial plan. Maximum characters: 1040. | |
| -Identity | String | yes | The Identity parameter is a unique identifier that designates the name of the tenant dial plan. Identity is an alphanumeric string that cannot exceed 49 characters. Valid characters are alphabetic or numeric... |
| -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 switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.