Commands › Microsoft Teams
New-CsVoiceNormalizationRule
Creates a new voice normalization rule.
Quick start script
# New-CsVoiceNormalizationRule — 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-CsVoiceNormalizationRule
$before | Format-List
# 3. Make the change (dry run first)
New-CsVoiceNormalizationRule -Identity <XdsIdentity> -Name <String> -WhatIf
New-CsVoiceNormalizationRule -Identity <XdsIdentity> -Name <String>
# 4. Verify and diff
$after = Get-CsVoiceNormalizationRule
Compare-Object ($before | Out-String) ($after | Out-String)Syntax — 2 parameter sets
Identity (Default)
New-CsVoiceNormalizationRule [-Tenant <Guid>] [-Description <String>] [-Pattern <String>]
[-Translation <String>] [-IsInternalExtension <Boolean>] [-Priority <Int32>] [-Identity] <XdsIdentity>
[-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]ParentAndRelativeKey
New-CsVoiceNormalizationRule [-Tenant <Guid>] -Parent <String> -Name <String> [-Description <String>]
[-Pattern <String>] [-Translation <String>] [-IsInternalExtension <Boolean>] [-Priority <Int32>] [-InMemory]
[-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (13)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before executing the command. | |
| -Description | String | A friendly description of the normalization rule. | |
| -Force | SwitchParameter | Suppresses any confirmation prompts that would otherwise be displayed before making changes. | |
| -Identity | XdsIdentity | yes | A unique identifier for the rule. The Identity specified must include the scope followed by a slash and then the name; for example: site:Redmond/Rule1, where site:Redmond is the scope and Rule1 is the name. The name... |
| -InMemory | SwitchParameter | Creates an object reference without actually committing the object as a permanent change. | |
| -IsInternalExtension | Boolean | If True, the result of applying this rule will be a number internal to the organization. If False, applying the rule results in an external number. This value is ignored if the value of the OptimizeDeviceDialing... | |
| -Name | String | yes | The name of the rule. This parameter is required if a value has been specified for the Parent parameter. If no value has been specified for the Parent parameter, Name defaults to the name specified in the Identity... |
| -Parent | String | The scope at which the new normalization rule will be created. This value must be global; site:\<sitename\>, where \<sitename\> is the name of the Skype for Business Server site; PSTN gateway or Registrar service,... | |
| -Pattern | String | A regular expression that the dialed number must match in order for this rule to be applied. | |
| -Priority | Int32 | The order in which rules are applied. A phone number might match more than one rule. This parameter sets the order in which the rules are tested against the number. | |
| -Tenant | Guid | For internal Microsoft usage. | |
| -Translation | String | The regular expression pattern that will be applied to the number to convert it to E.164 format. | |
| -WhatIf | SwitchParameter | 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.