New-CsAddressBookNormalizationRule

Skype for Business Server 2015
 

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

새 주소록 정규화 규칙을 만듭니다. 주소록 정규화 규칙은 비즈니스용 Skype 서버 2015에서 쉽게 이해할 수 있는 형식으로 전화 번호를 변환하는 데 사용됩니다.

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

New-CsAddressBookNormalizationRule -Identity <XdsIdentity> <COMMON PARAMETERS>
New-CsAddressBookNormalizationRule -Name <String> -Parent <String> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

예제 1의 명령은 RedmondFourDigit이라는 새 주소록 정규화 규칙을 만듭니다. 이 규칙은 Redmond 사이트에 할당된 정규화 규칙 컬렉션에 포함됩니다. 이 새 규칙은 4자리 내선 번호만 사용하여 내부에서 거는 번호를 변환하도록 설계되었습니다. 이 예제에서는 4자리 숫자를 식별하는 데 Pattern 속성이 사용되고, 값 +1425555를 이와 같은 4자리 숫자 각각에 추가하는 데 Translation 속성이 사용됩니다. 예를 들어 내선 번호가 1234인 경우 이 규칙에 의해서 전화를 건 번호가 +14255551234로 변환됩니다.

Pattern 및 Translation 값은 작은따옴표로 묶여 있습니다. 이러한 값에는 작은따옴표가 필요합니다. 큰따옴표(또는 따옴표가 없는 경우)가 있으면 명령이 실패합니다.

New-CsAddressBookNormalizationRule -Parent "site:Redmond" -Name RedmondFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1425555$1'

정규화 규칙은 숫자를 내부 비즈니스용 Skype 서버 2015 형식에서 표준(E.164) 형식으로 변환하기 위한 요구 사항을 정의합니다. 정규식을 알면 정규화 규칙이 무엇이고 어떻게 작동하는지 이해하는 데 도움이 됩니다. 주소록 정규화 규칙은 주소록 서버에 대해 이러한 변환을 처리합니다.

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

 

매개 변수 필수 유형 설명

Identity

필수

Microsoft.Rtc.Management.Xds.XdsIdentity

규칙에 대한 고유 식별자입니다. 지정된 Identity에는 범위가 포함되어야 하며, 그 뒤에 슬래시와 이름이 차례로 와야 합니다. 예를 들어 site:Redmond/Rule1에서 site:Redmond는 범위이고 Rule1은 이름입니다.

Identity는 Parent(범위)와 Name으로 구성됩니다. Identity 매개 변수를 사용할 경우 Name 또는 Parent 매개 변수를 사용할 수 없습니다.

Name

필수

System.String

새 규칙에 지정할 이름입니다. Parent 매개 변수에 값이 지정된 경우 이 매개 변수가 필요합니다. Parent 매개 변수에 대해 지정된 값이 없을 경우에는 Name의 기본값이 Identity 매개 변수에 사용된 이름으로 설정됩니다. 예를 들어 ID가 site:Redmond/RedmondRule인 규칙을 만들 경우 이름은 기본적으로 RedmondRule입니다. Name 매개 변수와 Identity 매개 변수를 같은 명령에서 사용할 수는 없습니다.

Parent

필수

System.String

새 정규화 규칙이 만들어질 범위입니다. 주소록 정규화 규칙은 전역 범위, 사이트 범위 또는 서비스 범위(주소록 서비스에만 해당됨)에서 만들 수 있습니다. 주소록 정규화 구성 설정의 컬렉션을 미리 지정된 범위에 할당해야만 해당 범위에 규칙을 추가할 수 있습니다. 예를 들어 이미 해당 사이트에 대해 주소록 정규화 구성 설정을 만든 경우에만 Redmond 사이트에 규칙을 추가할 수 있습니다.

Identity 매개 변수가 지정되지 않은 경우 Parent 매개 변수가 필요합니다. 같은 명령에 Identity 매개 변수와 Parent 매개 변수를 함께 포함할 수는 없습니다. Parent 매개 변수를 포함할 경우 Name 매개 변수도 필요합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

Description

선택

System.String

관리자는 정규화 규칙과 함께 설명 텍스트를 제공할 수 있습니다. 예를 들어 Description은 규칙이 전화 번호를 변환하는 방법을 설명합니다.

Force

선택

System.Management.Automation.SwitchParameter

변경하기 전에 표시되는 확인 메시지를 표시하지 않습니다.

InMemory

선택

System.Management.Automation.SwitchParameter

개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set-<cmdlet>을 호출하여 해당 변경 사항을 커밋할 수 있습니다.

Pattern

선택

System.String

이 규칙을 적용하기 위해 전화 번호와 일치해야 하는 정규식입니다.

기본값은 ^(\d{11})$입니다. 이 식은 최대 11자리 숫자 집합을 나타냅니다.

Priority

선택

System.Int32

규칙이 적용되는 순서입니다. 지정된 전화 번호가 여러 개의 규칙과 일치할 수 있기 때문에 필요합니다. Priority 매개 변수는 번호에 대해 규칙이 테스트되는 순서를 설정합니다. 전화 번호가 여러 개의 규칙과 일치할 경우 우선 순위가 가장 높은 규칙이 변환을 수행하도록 선택됩니다.

우선 순위를 설정하면 이에 따라 기존 규칙의 순서가 다시 매겨집니다.

Translation

선택

System.String

E.164 형식으로 변환하기 위해 번호에 적용되는 정규식 패턴입니다.

기본값은 +$입니다. 이 값은 더하기 기호(+)가 접두사로 번호에 추가됩니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

없음. New-CsAddressBookNormalizationRule cmdlet은 파이프라인된 입력을 허용하지 않습니다.

New-CsAddressBookNormalizationRule cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationRule#Decorated 개체의 인스턴스를 만듭니다.

 
표시: