Set-CsVoiceRoute

구문

Set-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceRoute [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

자세한 정보

이 cmdlet을 사용하여 기존 음성 경로를 수정합니다. 음성 경로는 PSTN(공중 전화망) 사용을 통해 음성 정책과 연결됩니다. 음성 경로는 지정된 음성 경로를 통해 경로 지정되는 전화 번호를 식별하는 정규식을 포함합니다. 정규식과 일치하는 전화 번호가 이 경로를 통해 경로 지정됩니다.

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceRoute"}

매개 변수

입력 형식

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 개체입니다. 음성 경로 개체의 파이프라인된 입력을 허용합니다.

반환 형식

Set-CsVoiceRoute는 값이나 개체를 반환하지 않습니다. 대신에 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 개체의 인스턴스를 구성합니다.

예제

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

Set-CsVoiceRoute -Identity Route1 -Description "Test Route"

이 명령은 Route1 음성 경로의 Description을 "Test Route"로 설정합니다.

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

Set-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"}

이 예제의 명령은 ID가 Route1인 음성 경로를 수정하여 PSTN 사용법 Long Distance를 이 음성 경로에 대한 사용법 목록에 추가합니다. Long Distance는 Get-CsPstnUsage를 호출하여 검색할 수 있는 글로벌 PSTN 사용법 목록에 포함되어야 합니다.

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

$x = (Get-CsPstnUsage).Usage
Set-CsVoiceRoute -Identity Route1 -PstnUsages @{replace=$x}

이 예제에서는 Route1이라는 음성 경로를 수정하여 해당 경로의 PSTN 사용법 목록을 조직의 모든 기존 사용법으로 채웁니다. 이 예제의 첫 번째 명령은 글로벌 PSTN 사용법의 목록을 검색합니다. Get-CsPstnUsage에 대한 호출이 괄호로 묶여 있으므로 먼저 PSTN 사용법 정보가 포함된 개체가 검색됩니다. 글로벌 PSTN 사용법이 하나만 있으므로 개체가 하나만 검색됩니다. 그런 다음, 이 개체의 Usage 속성이 검색됩니다. PSTN 사용법 목록을 포함하는 해당 속성은 변수 $x에 할당됩니다. 이 예제의 둘째 줄에서는 ID가 Route1인 음성 경로를 수정하기 위해 Set-CsVoiceRoute를 호출합니다. PstnUsages 매개 변수에 @{replace=$x} 값이 전달됩니다. 이 값은 이 경로의 PstnUsages 목록에 있는 모든 내용을 첫 줄에서 검색된 PSTN 사용법 목록을 포함하는 $x의 내용으로 대체하도록 지시합니다.

-------------------------- 예제 4 --------------------------

$x = Get-CsVoiceRoute -Identity Route1
$x.Name = "RouteA"
Set-CsVoiceRoute -Instance $x

이 명령 집합은 ID가 Route1인 음성 경로의 Name 속성을 RouteA로 변경합니다. Name 속성을 변경하면 Identity 속성이 자동으로 변경됩니다(이 경우에는 RouteA로).

첫째 줄에서는 ID가 Route1인 음성 경로를 검색하기 위해 Get-CsVoiceRoute를 호출합니다. 반환된 개체는 변수 $x에 저장됩니다. 다음으로 해당 개체의 Name 속성이 문자열 값 "RouteA"에 할당됩니다. 마지막으로 변경을 수행하기 위해 변수 $x에 포함된 개체가 Set-CsVoiceRoute의 Instance 매개 변수에 전달됩니다.

-------------------------- 예제 5 ------------------------

$y = Get-CsVoiceRoute -Identity Route1
$y.PstnGatewayList.Add("PstnGateway:192.168.0.100")
Set-CsVoiceRoute -Instance $y

이 예제에서는 Route1이라는 음성 경로를 수정하여 해당 경로의 PSTN 게이트웨이 목록(PstnGatewayList)을 ID가 PstnGateway:192.168.0.100인 게이트웨이의 서버 역할로 채웁니다. 이 예제의 첫째 줄에서는 Get-CsVoiceRoute를 호출하여 수정할 음성 경로(여기서는 Route1)를 검색합니다. 다음으로 Route1의 PstnGatewayList 속성에서 Add 메서드를 호출합니다. 추가할 서비스의 Identity를 Add 메서드에 전달합니다. 마지막으로 Set-CsVoiceRoute를 호출하고 Instance 매개 변수에 변수 $y를 전달하면 $y에 저장된 Route1이 새로 추가된 PSTN 게이트웨이로 업데이트됩니다.

참고 항목

기타 리소스

New-CsVoiceRoute
Remove-CsVoiceRoute
Get-CsVoiceRoute
Test-CsVoiceRoute
Get-CsPstnUsage
Get-CsService