Set-CsAddressBookNormalizationConfiguration

Set-CsAddressBookNormalizationConfiguration
    [[-Identity] <XdsIdentity>]
    [-AddressBookNormalizationRules <PSListModifier>]
    [-Confirm]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Set-CsAddressBookNormalizationConfiguration
    [-AddressBookNormalizationRules <PSListModifier>]
    [-Confirm]
    [-Force]
    [-Instance <PSObject>]
    [-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.) In Skype for Business Server, the Address Book normalization configuration settings represent collections of normalization rules designed to carry out these conversions and translations for Address Book server. (These collections can be defined at the global scope or at the site scope.) The Set-CsAddressBookNormalizationConfiguration cmdlet provides a way add or remove a normalization rule from any of these collections.

In general, you will probably find it easier to add or remove rules by using the CsAddressBookNormalizationRule cmdlets; these cmdlets enable you to add or remove rules using one command rather than two. However, as Example 2 shows, the Set-CsAddressBookNormalizationConfiguration cmdlet does enable you to copy rules from one collection to another.

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 that, in some cases, you might need to create identical rules: one for assignment to Address Book servers, the other for assignment to dial plans.

Remove-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"

The commands shown in Example 1 remove the Address Book normalization rule LongDistanceRule from the global collection of Address Book normalization configuration settings. In order to carry out this task, the first command in the example uses the Get-CsAddressBookNormalizationRule cmdlet to create an object reference to the normalization rule with the Identity global/LongDistanceRule. The resulting object reference is stored in a variable named $x.

The second command in the example then uses the Set-CsAddressBookNormalizationConfiguration cmdlet to remove the rule global/LongDistanceRule from the global collection. This is done by including the AddressBookNormalizationRules parameter and the syntax @{Remove=$x}.

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"

Set-CsAddressBookNormalizationConfiguration -Identity "global" -AddressBookNormalizationRules @{Remove=$x}

Alternatively, you could remove the rule by using the Remove-CsAddressBookNormalizationRule cmdlet

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"

Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules @{Add=$x}

The commands shown in Example 2 demonstrate how you can use the Set-CsAddressBookNormalizationConfiguration cmdlet to copy an Address Book normalization rule from one collection to another. To do this, the first command in the example uses the Get-CsAddressBookNormalizationRule cmdlet to create an object reference to the normalization rule with the Identity global/LongDistanceRule. The resulting object reference is stored in a variable named $x.

The second command in the example then uses the Set-CsAddressBookNormalizationConfiguration cmdlet to add this same rule to the configuration settings applied to the Redmond site. This is done by first connecting to the configuration settings for the Redmond site, then using the AddressBookNormalizationRules parameter and the syntax @{Add=$x}. When this command finishes running, both the global collection and the Redmond site collection will have a normalization rule named LongDistanceRule.

Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules $Null

In Example 3, all the Address Book normalization rules assigned to the Redmond site are deleted; this is done by setting the AddressBookNormalizationRules parameter to a null value ($Null). Note that the Redmond site collection will still exist. However, no normalization rules will be assigned to that collection.

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-CsAddressBookNormalizationConfiguration cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings object.

Instead, the Set-CsAddressBookNormalizationConfiguration cmdlet modifies existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings object.