Import-CsCompanyPhoneNormalizationRules

Use the Import-CsCompanyPhoneNormalizationRules cmdlet to import custom phone normalization rules defined in Company_Phone_Number_Normalization_Rules.txt used in previous server versions into Skype for Business Server environments.

Syntax

Import-CsCompanyPhoneNormalizationRules
      [[-Identity] <XdsIdentity>]
      -FileName <String>
      [-Confirm]
      [-Force]
      [-WhatIf]
      [<CommonParameters>]
Import-CsCompanyPhoneNormalizationRules
      -FileName <String>
      [-Confirm]
      [-Force]
      [-Instance <PSObject>]
      [-WhatIf]
      [<CommonParameters>]

Description

Address Book phone normalization rule configurations have been migrated from the plain text file Company_Phone_Number_Normalization_Rules.txt to central management configuration in Skype for Business Server for easier and more convenient manageability. In order for the Skype for Business Server Address Book service to pick up custom normalization rules, normalization rule definitions must be in the central management configuration store. The Import-CsCompanyPhoneNormalizationRules cmdlet reads all custom normalization rules defined in the file specified by the FileName parameter and ensures the same normalization rules exist in the central management configuration store. Company_Phone_Number_Normalization_Rules.txt and phone normalization rules defined in central management store must be kept in sync until the environment is fully migrated to Skype for Business Server.

The Import-CsCompanyPhoneNormalizationRules cmdlet uses GUID names for the new normalization rules as name is required in the Skype for Business Server configuration schema, and does not exist in the legacy normalization file format. These GUID names can be replaced with more appropriate values by using Set-CsAddressBookNormalizationConfiguration cmdlet after the migration is completed.

Alternatively, the New-CsAddressBookNormalizationConfiguration and Set-CsAddressBookNormalizationConfiguration cmdlets can also be used to keep custom normalization rule definitions in sync.

Examples

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

Import-CsCompanyPhoneNormalizationRules -Filename "C:\Data\Company_Phone_Number_Normalization_Rules.txt" -Identity Global

This example reads the phone normalization rules at the specified path and applies them globally.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
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

-FileName

Specifies the full path to the input Company_Phone_Number_Normalization_Rules.txt file. For example:

-FileName "C:\Data\Company_Phone_Number_Normalization_Rules.txt"

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Force

Suppresses the display of any non-fatal error messages and completes the cmdlet operation.

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

-Identity

Unique identifier for the address book normalization configuration settings to be updated. To modify the global settings, use this syntax:

-Identity global

To modify settings configured at the site scope:

-Identity site:Redmond

To modify settings at the service level:

-Identity service:Registrar:atl-cs-001.litwareinc.com

Note that address book normalization configuration settings can only be applied to the Registrar service. An error will occur if you try to apply these settings to any other service.

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

-Instance

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
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

None