Set-CsDialPlan
마지막으로 수정된 항목: 2012-03-27
기존 다이얼 플랜을 수정합니다.
구문
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
이 cmdlet은 기존 다이얼 플랜(위치 프로필이라고도 함)을 수정합니다. 다이얼 플랜은 Enterprise Voice 사용자가 전화 통화를 할 수 있는 데 필요한 정보를 제공합니다. 또한 전화 접속 회의를 위해 회의 길잡이 응용 프로그램에서 다이얼 플랜이 사용됩니다. 다이얼 플랜은 어떤 정규화 규칙이 적용되는지, 외부 통화를 위해 접두사를 사용해야 하는지 여부 등을 결정합니다.
참고: 이 cmdlet을 사용하여 다이얼 플랜의 정규화 규칙을 수정할 수 있지만 New-CsVoiceNormalizationRule, Set-CsVoiceNormalizationRule 또는 Remove-CsVoiceNormalizationRule cmdlet을 대신 사용하는 것이 좋습니다. 이러한 cmdlet을 사용하면 변경 사항이 해당 다이얼 플랜에 반영됩니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsDialPlan cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialPlan"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
문자열 |
수정할 다이얼 플랜을 식별하기 위해 범위 또는 이름(사용자별 플랜의 경우)을 지정하는 고유한 식별자입니다. 예를 들어, 사이트 ID를 site:<sitename> 형식으로 입력할 수 있으며 여기서 sitename은 사이트의 이름입니다. 서비스 범위의 다이얼 플랜은 등록자 또는 PSTN 게이트웨이 서비스가 될 수 있으며 여기서 Identity 값의 형식은 Registrar:Redmond.litwareinc.com과 같습니다. 사용자별 ID는 고유한 문자열 값으로 입력됩니다. |
Instance |
선택 |
위치 프로필 |
개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다.Get-CsDialPlan cmdlet을 호출하여 이 개체 참조를 검색할 수 있습니다. |
Description |
선택 |
문자열 |
다이얼 플랜의 목적, 다이얼 플랜이 적용되는 사용자의 유형, 다이얼 플랜의 목적을 식별하는 데 도움이 되는 기타 정보와 같은 이 다이얼 플랜에 대한 설명입니다. 최대 문자 길이: 512 |
DialinConferencingRegion |
선택 |
문자열 |
이 다이얼 플랜과 연관된 지역의 이름입니다. 전화 접속 회의에 다이얼 플랜을 사용할 경우 이 매개 변수 값을 지정합니다. 그러면 전화 회의 이끌이가 전화 회의를 설정할 때 올바른 액세스 번호를 할당할 수 있습니다. Get-CsNetworkRegion cmdlet을 호출하여 사용 가능한 지역을 검색할 수 있습니다. 최대 문자 길이: 512 |
ExternalAccessPrefix |
선택 |
문자열 |
통화를 조직 외부 통화로 지정하는 번호(또는 번호 집합)입니다. (예를 들어, 외부 회선에 전화를 걸려면 먼저 9를 누릅니다.) 이 접두사는 정규화 규칙에서 무시되며 번호의 나머지 부분에는 이러한 규칙이 적용됩니다. 이 값을 적용하려면 OptimizeDeviceDialing 매개 변수를 True로 설정해야 합니다. 이 매개 변수 값은 정규식 [0-9]{1,4}와 일치해야 합니다. 즉, 길이가 1-4자리인 0-9 범위의 숫자 값이어야 합니다. |
NormalizationRules |
선택 |
PS 목록 한정자 |
이 다이얼 플랜에 적용되는 정규화 규칙의 목록입니다. 이 cmdlet을 사용하여 이 목록과 이러한 규칙을 직접 수정할 수 있지만 규칙을 만들어 지정한 다이얼 플랜에 할당하는 New-CsVoiceNormalizationRule cmdlet을 사용하여 정규화 규칙을 만들고 Set-CsVoiceNormalizationRule cmdlet을 사용하여 수정하는 것이 좋습니다. |
OptimizeDeviceDialing |
선택 |
부울 |
이 매개 변수를 True로 설정하면 조직 외부에서 걸려온 전화에 ExternalAccessPrefix 매개 변수의 접두사가 적용됩니다. ExternalAccessPrefix 매개 변수가 값이 지정된 경우에만 이 값을 True로 설정할 수 있습니다. |
SimpleName |
선택 |
문자열 |
다이얼 플랜의 알기 쉬운 이름입니다. 다이얼 플랜 이름은 Microsoft Lync Server 2010 배포 내의 모든 다이얼 플랜에서 고유해야 합니다. 이 문자열은 최대 256자일 수 있습니다. 유효한 문자는 알파벳 문자 또는 숫자, 하이픈(-), 점(.), 더하기(+), 밑줄(_) 및 괄호(())입니다. |
State |
선택 |
문자열 |
이 매개 변수는 이 cmdlet에 사용되지 않습니다. |
City |
선택 |
문자열 |
이 매개 변수는 이 cmdlet에 사용되지 않습니다. |
CountryCode |
선택 |
문자열 |
이 매개 변수는 이 cmdlet에 사용되지 않습니다. |
Force |
선택 |
스위치 매개 변수 |
변경을 수행하기 전에 확인 메시지가 표시되지 않도록 합니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 개체입니다. 다이얼 플랜 개체의 파이프라인된 입력을 허용합니다.
반환 형식
Set-CsDialPlan은 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 개체의 인스턴스를 구성합니다.
예제
-------------------------- 예제 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
예제 1에서는 Set-CsDialPlan을 사용하여 ID가 RedmondDialPlan인 다이얼 플랜을 수정합니다. 이 경우 수정할 유일한 속성은 Description입니다. Description 매개 변수 다음에 새 설명에 대한 텍스트를 지정하여 수정합니다.
-------------------------- 예제 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
이 예제에서는 Set-CsDialPlan을 사용하여 조직에 사용하도록 구성된 모든 다이얼 플랜에 대한 ExternalAccessPrefix 속성 값을 변경합니다. 이를 수행하기 위해 먼저 Get-CsDialPlan을 사용하여 조직의 모든 다이얼 플랜 컬렉션을 반환합니다. 그런 다음, 컬렉션의 각 프로필에 대한 ExternalAccessPrefix 속성에 값 8을 할당하는 Set-CsDialPlan에 해당 컬렉션이 파이프됩니다.