Set-CsAddressBookNormalizationConfiguration

Skype for Business Server 2015
 

마지막으로 수정된 항목: 2017-03-28

주소록 정규화 구성 설정의 컬렉션을 하나 이상 수정합니다. 주소록 정규화 설정은 전화 번호를 비즈니스용 Skype 서버 2015에서 쉽게 이해할 수 있는 형식으로 전화 번호를 변환하는 데 사용됩니다.

이 cmdlet은 비즈니스용 Skype 서버 2015에 도입되었습니다.

Set-CsAddressBookNormalizationConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsAddressBookNormalizationConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AddressBookNormalizationRules <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

예제 1의 명령은 주소록 정규화 구성 설정의 전역 컬렉션에서 주소록 정규화 규칙 LongDistanceRule을 제거합니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 Get-CsAddressBookNormalizationRule cmdlet을 사용하여 ID가 global/LongDistanceRule인 정규화 규칙에 대한 개체 참조를 만듭니다. 이와 같은 방법으로 만든 개체 참조는 $x라는 변수에 저장됩니다.

이 예제의 두 번째 명령은 Set-CsAddressBookNormalizationConfiguraton cmdlet을 사용하여 전역 컬렉션에서 규칙 global/LongDistanceRule을 제거합니다. 이는 AddressBookNormalizationRules 매개 변수 및 구문 @{Remove=$x}.를 포함하여 수행됩니다.

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"
Set-CsAddressBookNormalizationConfiguration -Identity "global" -AddressBookNormalizationRules @{Remove=$x}

또는 Remove-CsAddressBookNormalizationRule cmdlet을 사용하여 규칙을 제거할 수 있습니다.

Remove-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"

예제 2의 명령은 Set-CsAddressBookNormalizationConfiguration cmdlet을 사용하여 하나의 컬렉션에서 다른 컬렉션으로 주소록 정규화 규칙을 복사하는 방법을 보여 줍니다. 이를 위해 예제의 첫 번째 명령은 Get-CsAddressBookNormalizationRule cmdlet을 사용하여 ID가 global/LongDistanceRule인 정규화 규칙에 대한 개체 참조를 만듭니다. 이와 같은 방법으로 만든 개체 참조는 $x라는 변수에 저장됩니다.

이 예제의 두 번째 명령은 Set-CsAddressBookNormalizationConfiguration cmdlet을 사용하여 이 동일한 규칙을 Redmond 사이트에 적용된 구성 설정을 추가합니다. 이는 먼저 Redmond 사이트에 대한 구성 설정에 연결한 뒤 AddressBookNormalizationRules 매개 변수 및 구문 @{Add=$x}를 사용하여 수행됩니다. 이 명령 실행이 완료되면 전역 컬렉션과 Redmond 사이트 컬렉션 모두에 LongDistanceRule이라는 정규화 규칙이 만들어집니다.

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"
Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules @{Add=$x}

예제 3에서는 Redmond 사이트에 할당된 모든 주소록 정규화 규칙이 삭제됩니다. 이는 AddressBookNormalizationRules 매개 변수를 Null 값($Null)으로 설정하여 수행됩니다. Redmond 사이트 컬렉션은 여전히 남아 있습니다. 하지만 해당 컬렉션에는 정규화 규칙이 할당되지 않습니다.

Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules $Null

정규화 규칙은 내부 비즈니스용 Skype 서버 2015 형식에서 표준(E.164) 형식으로 숫자를 변환하기 위한 요구 사항을 정의합니다. 정규식을 알면 정규화 규칙이 무엇이고 어떻게 작동하는지 이해하는 데 도움이 됩니다. 비즈니스용 Skype 서버 2015에서 주소록 정규화 구성 설정은 주소록 서버에 대해 이러한 변환을 수행하기 위해 설계된 정규화 규칙의 컬렉션을 나타냅니다. 이 컬렉션은 전역 범위 또는 사이트 범위에서 정의할 수 있습니다. Set-CsAddressBookNormalizationConfiguration cmdlet은 이 컬렉션에서 정규화 규칙을 추가하거나 제거할 수 있는 방법을 제공합니다.

일반적으로 CsAddressBookNormalizationRule cmdlet을 사용하면 보다 쉽게 규칙을 추가하거나 제거할 수 있습니다. 이 cmdlet을 사용하면 두 개가 아닌 하나의 명령을 사용해 규칙을 추가하거나 제거할 수 있습니다. 하지만 예제 2에 나와 있는 대로 Set-CsAddressBookNormalizationConfiguration cmdlet에서는 하나의 컬렉션에서 다른 컬렉션으로 규칙을 복사할 수 있습니다.

주소록 정규화 규칙과 음성 정규화가 매우 비슷하기는 하지만 이 둘을 서로 바꿀 수는 없습니다. 음성 정규화 규칙을 주소록 컬렉션에 추가하거나, 주소록 정규화 규칙을 다이얼 플랜에 추가할 수 없습니다. 즉, 경우에 따라서 주소록 서버와 다이얼 플랜에 할당할 동일한 규칙을 하나씩 만들어야 할 수 있습니다.

 

매개 변수 필수 유형 설명

AddressBookNormalizationRules

선택

System.Management.Automation.PSListModifier

이 주소록 정규화 구성 설정의 컬렉션에 적용된 정규화 규칙의 집합입니다.

이 cmdlet을 사용하여 이 규칙 집합을 직접 수정할 수 있지만 New-CsAddressBookNormalizationRule cmdlet을 사용해 정규화 규칙을 만드는 것이 좋습니다. 이 cmdlet은 규칙을 만들어 지정된 컬렉션에 할당합니다. 그리고 나서 Set-CsAddressBookNormalizationRule cmdlet을 사용하여 해당 규칙을 수정하거나 Remove-CsAddressBookNormalizationRule cmdlet을 사용하여 컬렉션에서 규칙을 삭제할 수 있습니다. 일반적으로 이 방법은 Set-CsAddressBookNormalizationConfiguration cmdlet 및 AddressBookNormalizationRules 매개 변수를 사용하여 규칙 컬렉션을 수정하는 것보다 쉽고 오류가 발생할 확률이 적습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

명령을 실행하기 전에 확인 메시지를 표시합니다.

Force

선택

System.Management.Automation.SwitchParameter

변경을 수행하기 전에 확인 메시지가 표시되지 않도록 합니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

수정할 주소록 정규화 구성 설정의 컬렉션에 대한 고유 식별자입니다. 전역 설정을 참조하려면 -Identity "global" 구문을 사용합니다.

사이트 범위에서 구성된 컬렉션을 참조하려면 -Identity "site:Redmond"와 같은 구문을 사용합니다.

ID를 지정할 때는 와일드카드를 사용할 수 없습니다.

Instance

선택

System.Management.Automation.PSObject

개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

AddressBookNormalizationRules

선택

System.Management.Automation.PSListModifier

이 주소록 정규화 구성 설정의 컬렉션에 적용된 정규화 규칙의 집합입니다.

이 cmdlet을 사용하여 이 규칙 집합을 직접 수정할 수 있지만 New-CsAddressBookNormalizationRule cmdlet을 사용해 정규화 규칙을 만드는 것이 좋습니다. 이 cmdlet은 규칙을 만들어 지정된 컬렉션에 할당합니다. 그리고 나서 Set-CsAddressBookNormalizationRule cmdlet을 사용하여 해당 규칙을 수정하거나 Remove-CsAddressBookNormalizationRule cmdlet을 사용하여 컬렉션에서 규칙을 삭제할 수 있습니다. 일반적으로 이 방법은 Set-CsAddressBookNormalizationConfiguration cmdlet 및 AddressBookNormalizationRules 매개 변수를 사용하여 규칙 컬렉션을 수정하는 것보다 쉽고 오류가 발생할 확률이 적습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

명령을 실행하기 전에 확인 메시지를 표시합니다.

Force

선택

System.Management.Automation.SwitchParameter

변경을 수행하기 전에 확인 메시지가 표시되지 않도록 합니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

수정할 주소록 정규화 구성 설정의 컬렉션에 대한 고유 식별자입니다. 전역 설정을 참조하려면 -Identity "global" 구문을 사용합니다.

사이트 범위에서 구성된 컬렉션을 참조하려면 -Identity "site:Redmond"와 같은 구문을 사용합니다.

ID를 지정할 때는 와일드카드를 사용할 수 없습니다.

Instance

선택

System.Management.Automation.PSObject

개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

Set-CsAddressBookNormalizationConfiguration cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings 개체의 파이프라인된 인스턴스를 허용합니다.

없음. 대신 Set-CsAddressBookNormalizationConfiguration cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings 개체의 기존 인스턴스를 수정합니다.

 
표시: