Get-CsAddressBookNormalizationConfiguration
Returns the Address Book normalization configuration settings currently in use in the organization. Address Book normalization settings are used to convert phone numbers to a format readily understood by Skype for Business Server.
Syntax
Get-CsAddressBookNormalizationConfiguration
[-Filter <String>]
[-LocalStore]
[<CommonParameters>] Get-CsAddressBookNormalizationConfiguration
[[-Identity] <XdsIdentity>]
[-LocalStore]
[<CommonParameters>] Description
Normalization rules define the requirements for converting (or translating) numbers from an internal Skype for Business Server format to the standard (E.164) format. (Note that an understanding of regular expressions is helpful in order to understood what normalization rules do and how they work.) In Skype for Business Server, the Address Book normalization configuration settings represent collections of normalization created for use by the Address Book server. (These collections can be defined at the global scope or at the site scope.) The Get-CsAddressBookNormalizationConfiguration cmdlet provides a way to return information about the Address Book normalization rules currently in use in your organization.
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.
Examples
-------------------------- Example 1 --------------------------
Get-CsAddressBookNormalizationConfigurationThe command shown in Example 1 returns a collection of all the Address Book normalization configuration settings currently in use in the organization. This is done by calling the Get-CsAddressBookNormalizationConfiguration cmdlet without any additional parameters.
-------------------------- Example 2 --------------------------
Get-CsAddressBookNormalizationConfiguration -Identity "site:Redmond"In Example 2, information is returned for a single collection of normalization rules: the collection with the Identity site:Redmond:
-------------------------- Example 3 --------------------------
Get-CsAddressBookNormalizationConfiguration -Filter "site:*"Example 3 returns information about all the normalization configuration settings applied to the site scope. To do this, the command uses the Filter parameter and the parameter value "site:*". That syntax limits the returned data to all the collections that have an Identity that begins with the string value "site:".
Parameters
-Filter
Enables you to use wildcard characters in order to return a collection (or multiple collections) of Address Book normalization configuration settings. For example, to return a collection of all the settings configured at the site scope, use this syntax: -Filter "site:*"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
Unique identifier for the collection of Address Book normalization configuration settings to be returned. To refer to the global settings, use this syntax: -Identity global
To refer to a collection configured at the site scope, use syntax similar to this: -Identity "site:Redmond"
Note that you cannot use wildcards when specifying an Identity. If you need to use wildcards, use the Filter parameter instead.
If this parameter is not specified, then the Get-CsAddressBookNormalizationConfiguration cmdlet returns a collection of all the Address Book normalization configuration settings in use in the organization.
| Type: | XdsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-LocalStore
Retrieves the Address Book normalization configuration data from the local replica of the Central Management store rather than from the Central Management store itself.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
None
Outputs
Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings