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-CsAddressBookNormalizationConfiguration
The 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
Related Links
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기