Edit

Share via


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

Identity

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

Instance

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

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

Prompts you for confirmation before executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FileName

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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"

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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.

Parameter properties

Type:XdsIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Instance

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Instance
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

None