다음을 통해 공유

  • 아티클

New-CsVoicePolicy

 

마지막으로 수정된 항목: 2012-03-25

새 음성 정책을 만듭니다.

구문

New-CsVoicePolicy -Identity <XdsIdentity> [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

자세한 정보

이 cmdlet은 새 음성 정책을 만듭니다. 음성 정책은 동시 벨 울림(누군가가 사무실 전화에 전화를 걸 때마다 또 다른 전화에서 벨이 울리는 기능) 및 착신 전환과 같은 Enterprise Voice 관련 기능을 관리하는 데 사용됩니다. 이 cmdlet이 만든 정책은 이러한 대부분의 기능이 활성화 또는 비활성화되는지 여부를 결정합니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsVoicePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoicePolicy"}

매개 변수

Parameter 필수 유형 설명

Identity

필수

Xds ID

정책의 범위 또는 이름을 지정하는 고유 식별자입니다. 이 cmdlet에 사용할 수 있는 값은 site:<site name>(여기서 <site name>은 Microsoft Lync Server 2010 사이트의 이름, 예: site:Redmond) 및 사용자별 정책을 지정하는 문자열(예: RedmondVoicePolicy)입니다. 글로벌 정책은 기본적으로 존재합니다.

AllowCallForwarding

선택

부울

이 매개 변수가 True로 설정된 경우에는 통화를 착신 전환할 수 있습니다. 이 매개 변수가 False로 설정된 경우 통화를 전달할 수 없습니다.

기본값: True

AllowPSTNReRouting

선택

부울

이 매개 변수를 True로 설정하면 풀이나 WAN을 사용할 수 없는 경우 지역 번호가 같은 다른 풀의 번호로 걸려 온 전화가 PSTN(공중 전화망)을 통해 경로 지정됩니다.

기본값: True

AllowSimulRing

선택

부울

동시 벨 울림은 한 번호로 전화를 걸었을 때 여러 개의 전화에서 벨이 울리는 기능입니다. 이 매개 변수를 True로 설정하면 이 기능이 활성화됩니다. 이 매개 변수가 False로 설정된 경우 이 정책이 할당된 모든 사용자에 대해 동시 벨 울림을 구성할 수 없습니다.

기본값: True

Description

선택

문자열

음성 정책에 대한 설명입니다.

최대 길이: 1040자

EnableBWPolicyOverride

선택

부울

대역폭을 제한하는 것을 비롯하여 네트워크 구성을 관리하기 위해 정책을 설정할 수 있습니다. 이 매개 변수를 True로 설정하면 이러한 정책을 무시할 수 있습니다. 즉, 이 매개 변수를 True로 설정하면 CAC(통화 허용 제어) 설정에 관계없이 대역폭을 확인하지 않고 통화가 실행됩니다.

기본값: False

EnableCallPark

선택

부울

통화 대기 응용 프로그램은 통화를 나중에 검색하기 위해 범위 내의 특정 번호에서 보류 또는 대기시키는 것을 허용합니다. 이 매개 변수를 True로 설정하면 이 응용 프로그램이 활성화됩니다. 이 매개 변수를 False로 설정할 경우 이 정책에 할당된 사용자는 자신의 전화 번호로 걸려 온 통화를 대기시킬 수 없습니다.

기본값: False

EnableCallTransfer

선택

부울

통화를 다른 번호로 전송할 수 있는지 여부를 결정합니다. 이 매개 변수가 True로 설정된 경우 통화를 전송할 수 있고 이 매개 변수가 False로 설정된 경우 통화를 전송할 수 없습니다.

기본값: True

EnableDelegation

선택

부울

통화 위임은 한 사용자가 다른 사용자의 전화를 받거나 다른 사람을 대신하여 전화를 거는 것을 허용합니다. 예를 들어, 운영자는 전화가 걸려오면 자신의 전화와 관리자의 전화 둘 다에서 벨이 울리도록 통화 위임을 설정할 수 있습니다. 이 매개 변수를 True로 설정하면 이 정책을 가진 사용자가 통화 위임을 설정할 수 있습니다. 이 매개 변수를 False로 설정하면 통화 위임이 비활성화됩니다.

기본값: True

EnableMaliciousCallTracing

선택

부울

악의적 통화 추적은 사용자가 악의적인 것으로 지정한 통화를 추적하는 표준입니다. 호출자 ID가 차단된 경우에도 이러한 통화를 추적할 수 있습니다. 추적은 사용자가 아니라 올바른 기관에만 사용할 수 있습니다. 이 속성을 True로 설정하면 악의적인 통화를 추적하는 기능이 활성화됩니다.

기본값: False

EnableTeamCall

선택

부울

팀 통화를 사용하면 사용자는 자신에게 전화가 걸려 왔을 때 다른 사용자의 전화가 울리도록 다른 사용자의 그룹을 지정할 수 있습니다. 예를 들어, 팀의 모든 구성원이 고객의 전화를 받을 수 있는 상황에서 이 기능이 유용합니다. 이 매개 변수를 True로 설정하면 이 기능이 활성화됩니다.

기본값: True

Name

선택

문자열

이 정책을 설명하는 표시 가능한 이름입니다.

기본값: DefaultPolicy

PreventPSTNTollBypass

선택

부울

PSTN 유료 전화는 장거리 요금으로 더 잘 알려져 있습니다. 경우에 따라 조직에서는 지점 사무실이 네트워크 통화를 통해 연결할 수 있는 VoIP(Voice over Internet Protocol) 솔루션을 구현하여 이러한 유료 전화를 우회할 수 있습니다. 이 매개 변수를 True로 설정하면 네트워크를 통과하여 유료 전화를 우회하는 대신에 PSTN을 통해 통화가 전송되고 요금이 발생합니다.

기본값: False

PstnUsages

선택

PS 목록 한정자

이 정책에 사용할 수 있는 PSTN 사용법 목록입니다. PSTN 사용법은 음성 정책을 전화 경로에 연결합니다.

PSTN 사용법의 현재 글로벌 목록에 있는 값이라면 어떤 문자열 값이라도 이 목록에 넣을 수 있습니다. 중복된 문자열은 허용되지 않으며 모든 문자열은 고유해야 합니다. Get-CsPstnUsage cmdlet을 호출하여 PSTN 사용법의 목록을 검색할 수 있습니다.

이 목록은 기본적으로 비어 있습니다. 이 매개 변수에 값을 지정하지 않으면 이 정책을 부여 받은 사용자가 아웃바운드 PSTN 호출을 수행할 수 없다는 경고 메시지가 표시됩니다.

Force

선택

스위치 매개 변수

변경 작업을 수행하기 전에 표시되는 모든 확인 메시지를 표시하지 않습니다.

InMemory

선택

스위치 매개 변수

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

WhatIf

선택

스위치 매개 변수

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

Confirm

선택

스위치 매개 변수

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

입력 형식

없음.

반환 형식

이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy 개체의 인스턴스를 만듭니다.

예제

-------------------------- 예제 1 --------------------------

New-CsVoicePolicy -Identity UserVoicePolicy1

이 예제에서는 기본 설정을 사용하며 ID가 UserVoicePolicy1인 새 사용자별 음성 정책을 만듭니다.

-------------------------- 예제 2 --------------------------

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

이 예제에서는 ID가 UserVoicePolicy2인 새 사용자별 음성 정책을 만들고 AllowSimulRing 속성을 False로 설정합니다. 따라서 이 정책이 할당된 모든 사용자는 사용자의 사무실 전화기에 전화가 왔을 때 다른 전화(예: 휴대폰)에도 벨이 울리는지 여부를 결정하는 동시 벨 울림 기능을 사용할 수 없습니다. 이 명령은 또한 PSTN 사용법의 목록에 "Local"을 추가하여 로컬 PSTN 사용법을 사용하는 음성 경로에 이 음성 정책을 연결합니다. (Identity 매개 변수가 명시적으로 지정되지 않았습니다. Identity 매개 변수는 위치 매개 변수이므로 매개 변수 목록에서 ID 값을 처음 포함한 경우 해당 값이 Identity라는 것을 명시적으로 지정할 필요가 없습니다.)

-------------------------- 예제 3 --------------------------

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

이 예제에서는 사이트 Redmond에 대한 새 음성 정책을 만들고 조직에 정의된 모든 PSTN 사용법을 이 정책에 적용합니다. 이 예제의 첫째 줄은 Get-CsPstnUsage cmdlet을 호출하여 조직에 대한 PSTN 사용법의 글로벌 집합을 검색하고 이를 변수 $a에 저장합니다. 둘째 줄은 New-CsVoicePolicy를 호출하여 사이트 Redmond에 대한 새 음성 정책을 만듭니다. PSTN 사용법의 글로벌 집합에 포함되어 있는 목록을 이 정책에 추가하기 위해 PstnUsages 매개 변수에 값이 전달됩니다. 추가된 값의 구문은 $a.Usage입니다. 이 구문은 PSTN 사용법 목록을 포함하는 PSTN 사용법 설정의 Usage 속성을 나타냅니다.