Remove-CsAddressBookNormalizationRule

Removes an Address Book normalization rule. Address Book normalization rules are used to convert phone numbers to a format readily understood by Skype for Business Server.

Syntax

Remove-CsAddressBookNormalizationRule
      [-Identity] <XdsIdentity>
      [-Confirm]
      [-Force]
      [-WhatIf]
      [<CommonParameters>]

Description

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.) The Address Book normalization rules handle these conversions and translations for the Address Book server.

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 server, the other for assignment to dial plans.

Examples

-------------------------- Example 1 --------------------------

Remove-CsAddressBookNormalizationRule -Identity "Global/Generic_All"

The command shown in Example 1 removes the Generic_All normalization rule from the global collection of Address Book normalization rules.

-------------------------- Example 2 --------------------------

Get-CsAddressBookNormalizationRule -Identity "site:Redmond" | Remove-CsAddressBookNormalizationRule

In Example 2, all the normalization rules are removed from the collection of Address Book normalization rules assigned to the Redmond site. To do this, the Get-CsAddressBookNormalizationRule cmdlet is first used to retrieve all the rules assigned to the Redmond site. Those rules are then piped to and deleted by, the Remove-CsAddressBookNormalizationRule cmdlet. When the command finishes running the normalization rules collection for the Redmond site will still exist, but the collection will no longer contain any rules.

-------------------------- Example 3 --------------------------

Get-CsAddressBookNormalizationRule | Where-Object {$_.Pattern -eq "E164"} | Remove-CsAddressBookNormalizationRule

Example 3 removes all Address Book normalization rules where the Pattern property is equal to E164. To carry out this task, the command first uses Get-CsAddressBookNormalizationRule to return a collection of all the available normalization rules. That collection is then piped to the Where-Object cmdlet, which picks out only those rules where the Pattern property is equal to E164. Any rules that meet that criterion are then piped to the Remove-CsAddressBookNormalizationRule cmdlet and are deleted.

Required Parameters

-Identity

Unique identifier for the rule being removed. The Identity specified must include the scope followed by a slash followed by the name; for example: site:Redmond/Rule1, where site:Redmond is the scope and Rule1 is the name.

Type:XdsIdentity
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
Applies to:Skype for Business Server 2015

Optional Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-Force

Suppresses any confirmation prompts that would otherwise be displayed before making changes.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015

Inputs

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

Outputs

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