New-CsVoicePolicy

구문

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"}

매개 변수

입력 형식

없음.

반환 형식

이 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 속성을 나타냅니다.

참고 항목

기타 리소스

Remove-CsVoicePolicy
Set-CsVoicePolicy
Get-CsVoicePolicy
Grant-CsVoicePolicy
Test-CsVoicePolicy
Get-CsPstnUsage