| external help file | online version | applicable | title | schema | manager | author | ms.author | ms.reviewer |
|---|---|---|---|---|---|---|---|---|
Microsoft.Rtc.Management.dll-help.xml |
Skype for Business Server 2015, Skype for Business Server 2019 |
Remove-CsAddressBookNormalizationConfiguration |
2.0.0 |
rogupta |
hirenshah1 |
hirshah |
Deletes one or more collections of Address Book normalization configuration settings. Address Book normalization settings are used to convert phone numbers to a format readily understood by Skype for Business Server.
Remove-CsAddressBookNormalizationConfiguration [-Identity] <XdsIdentity> [-Confirm] [-Force] [-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 that carry out these conversions and translations for Address Book servers.
(These settings can be defined at the global scope or at the site scope.) The Remove-CsAddressBookNormalizationConfiguration cmdlet provides a way delete normalization rule configuration settings that have been configured at the site scope.
This cmdlet can also be run against the global collection of settings.
In that case, however, the global settings will not be removed; that's because the global collection cannot be deleted.
However, all the properties in the global collection will be reset to their default values.
That means that any custom rules you have created for the global collection will be deleted.
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.
Remove-CsAddressBookNormalizationConfiguration -Identity "site:Redmond"
The command shown in Example 1 deletes the Address Book normalization configuration settings currently applied to the Redmond site. After this collection has been deleted, Address Book servers in the Redmond site will use the global configuration settings to handle phone number normalization.
Get-CsAddressBookNormalizationConfiguration -Filter "site:*" | Remove-CsAddressBookNormalizationConfiguration
In Example 2, all the Address Book normalization configuration settings applied to the site scope are deleted.
To do this, the command first uses the Get-CsAddressBookNormalizationConfiguration cmdlet and the Filter parameter to return a collection of all the configuration settings applied to the site scope.
This collection is then piped to the Remove-CsAddressBookNormalizationConfiguration cmdlet, which removes each item in the collection.
When this command completes, the deployment will be limited to the global collection of Address Book normalization settings.
Unique identifier for the collection of Address Book configuration settings to be removed.
For example: -Identity "site:Redmond"
Note that you cannot use wildcards when specifying the collection to be removed.
Type: XdsIdentity
Parameter Sets: (All)
Aliases:
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: FalsePrompts you for confirmation before executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSuppresses the display of any non-fatal error message that might occur when running the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseDescribes what would happen if you executed the command without actually executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
The Remove-CsAddressBookNormalizationConfiguration cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings object.
None.
Instead, the Remove-CsAddressBookNormalizationConfiguration cmdlet deletes existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings object.
Get-CsAddressBookNormalizationConfiguration
New-CsAddressBookNormalizationConfiguration