Set-CsAddressBookNormalizationRule

Set-CsAddressBookNormalizationRule
    [[-Identity] <XdsIdentity>]
    [-Confirm]
    [-Description <String>]
    [-Force]
    [-Pattern <String>]
    [-Priority <Int32>]
    [-Translation <String>]
    [-WhatIf]
    [<CommonParameters>]

Set-CsAddressBookNormalizationRule
    [-Confirm]
    [-Description <String>]
    [-Force]
    [-Instance <PSObject>]
    [-Pattern <String>]
    [-Priority <Int32>]
    [-Translation <String>]
    [-WhatIf]
    [<CommonParameters>]

Normalization rules define the requirements for converting (or translating) numbers from an internal Skype for Business Server format to a standard (E.164) format. (Note that an understanding of regular expressions is helpful in order to understand what normalization rules do and how they do it.) Address Book normalization rules carry out these conversions and translations for Address Book servers.

Although Address Book normalization rules are very similar to voice normalization rules, the two are not interchangeable: you cannot add voice normalization rules to an Address Book collection, nor can you add Address Book normalization rules to a dial plan. That means, in some cases, you might need to create identical rules: one for assignment to Address Book servers, the other for assignment to dial plans.

Set-CsAddressBookNormalizationRule -Identity "Global/RedmondAddresses" -Priority 1

The command shown in Example 1 changes the priority of the RedmondAddresses normalization rule found in the global collection of Address Book normalization rules.

Get-CsAddressBookNormalizationRule | Where-Object {$_.Translation -eq '+1206556$1'} | Set-CsAddressBookNormalizationRule -Translation '+1425556$1'

In Example 2, all the normalization rules that use the Translation +12065556$1 are updated to use the Translation +14255556$1; this might be required if an area code changes from 206 to 425. To carry out this task, the Get-CsAddressBookNormalizationRule cmdlet is called in order to return a collection of all the available normalization rules. This collection is then piped to the Where-Object cmdlet, which picks out only those rules that have a Translation equal to +12065556$1. Those rules are then piped to the Set-CsAddressBookTranslationRule, which changes the Translation for each of these rules to +14255556$1.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

The Set-CsAddressBookNormalizationRule cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationRule#Decorated object.

Instead, the Set-CsAddressBookNormalizationRule cmdlet modifies existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationRule#Decorated object.