Set-CsVoiceNormalizationRule
마지막으로 수정된 항목: 2012-03-27
음성 정규화 규칙을 수정합니다. 음성 정규화 규칙은 전화 걸기 요구 사항(예: 외부 회선에 액세스하기 위해 9번 걸기)을 Microsoft Lync Server 2010에 사용되는 E.164 전화 번호 형식으로 변환하는 데 사용됩니다.
구문
Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
이 cmdlet은 명명된 음성 정규화 규칙을 수정합니다. 이러한 규칙은 전화 권한 부여 및 통화 경로 지정의 필수 부분입니다. 이러한 규칙은 번호를 내부 Lync Server 2010 형식에서 표준(E.164) 형식으로 변환하기 위한 요구 사항을 정의합니다. 정규식을 이해하면 변환될 숫자 패턴을 정의하는 데 도움이 됩니다.
이 cmdlet을 사용하여 수정한 규칙은 다이얼 플랜의 일부이며, Get-CsVoiceNormalizationRule cmdlet을 통해 액세스할 수 있는 것 외에도 Get-CsDialPlan cmdlet 호출을 통해 반환되는 NormalizationRules 속성을 통해 액세스할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsVoiceNormalizationRule cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceNormalizationRule"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
규칙에 대한 고유한 식별자입니다. 지정한 ID에는 범위, 슬래시 및 이름이 순서대로 포함되어야 합니다. 예를 들어, site:Redmond/Rule1에서 site:Redmond는 범위이고 Rule1은 이름입니다. |
Instance |
선택 |
정규화 규칙 |
개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다. 이 개체는 NormalizationRule 유형이어야 하며 Get-CsVoiceNormalizationRule을 호출하여 검색할 수 있습니다. |
Description |
선택 |
문자열 |
정규화 규칙에 대한 간단한 설명입니다. 최대 문자열 길이: 512자 |
IsInternalExtension |
선택 |
부울 |
True인 경우 이 규칙을 적용한 결과는 회사 내부의 번호가 됩니다. False인 경우 규칙을 적용한 결과는 외부 번호가 됩니다. 관련 다이얼 플랜의 OptimizeDeviceDialing 속성 값이 False로 설정된 경우 이 값은 무시됩니다. |
Priority |
선택 |
Int32 |
규칙이 적용되는 순서입니다. 번호는 둘 이상의 규칙과 일치할 수 있습니다. 이 매개 변수는 번호에 대해 규칙이 테스트되는 순서를 설정합니다. |
Pattern |
선택 |
문자열 |
이 규칙을 적용하기 위해 전화 건 번호가 일치해야 하는 정규식입니다. |
Translation |
선택 |
문자열 |
E.164 형식으로 변환하기 위해 번호에 적용되는 정규식 패턴입니다. |
Force |
선택 |
스위치 매개 변수 |
변경 작업을 수행하기 전에 표시되는 확인 메시지가 표시되지 않도록 합니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 개체입니다. 음성 정규화 규칙 개체의 파이프라인된 입력을 허용합니다.
반환 형식
Set-CsVoiceNormalizationRule은 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 개체의 인스턴스를 구성합니다.
예제
-------------------------- 예제 1 --------------------------
Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"
이 예제는 사이트 Redmond에서 규칙 Prefix Redmond의 설명을 "Add a prefix to all numbers on site Redmond(사이트 Redmond의 모든 번호에 접두사 추가)"로 설정합니다.
-------------------------- 예제 2 --------------------------
Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'
이 예제에서는 ID가 global/SeattleFourDigit인 음성 정규화 규칙을 수정합니다. 규칙에 대한 수정 사항을 반영하기 위해 새 Description이 지정되었습니다. 또한 이 규칙의 기존 패턴과 일치하는 번호를 동일하지만 접두사 +1206556이 있는 번호로 변환하기 위해 규칙을 수정하는 Translation 값이 지정되었습니다. 예를 들어, 기존 패턴이 4자리 번호와 일치하고 번호 1234를 입력한 경우 이 규칙은 해당 내선 번호를 +12065561234로 변환합니다.
-------------------------- 예제 3 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a
예제 3에서는 정규화 규칙의 이름을 변경합니다. 이름을 변경하면 해당 ID의 이름 부분도 변경됩니다. Set-CsVoiceNormalizationRule cmdlet에는 -Name 매개 변수가 없으므로 이름을 변경하기 위해 먼저 Get-CsVoiceNormalizationRule을 호출하여 ID가 global/RedmondFourDigit인 규칙을 검색하고 반환된 개체를 변수 $a에 할당합니다. 그런 다음, 문자열 RedmondRule을 개체의 Name 속성에 할당합니다. 다음으로 이 변수를 Set-CsVoiceNormalizationRule의 Instance 매개 변수에 전달하여 영구적으로 변경합니다.