Remove-CsVoiceRoute
마지막으로 수정된 항목: 2012-03-25
음성 경로를 제거합니다. 음성 경로는 Enterprise Voice 사용자의 통화를 PSTN(공중 전화망) 또는 PBX(Private Branch Exchange)의 전화 번호로 경로 지정하는 방법을 Microsoft Lync Server 2010에 지정하는 명령을 포함합니다.
구문
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
자세한 정보
이 cmdlet을 사용하여 기존 음성 경로를 제거합니다. 음성 경로는 PSTN 사용법을 통해 음성 정책과 연관되므로 음성 경로를 제거해도 음성 정책과 관련된 값이 변경되지 않으며 삭제된 음성 경로의 패턴과 일치했던 번호의 경로 지정만 변경됩니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Remove-CsVoiceRoute cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoiceRoute"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Xds 글로벌 상대 ID |
삭제할 음성 경로를 고유하게 식별하는 문자열입니다. (Test Route와 같이 경로 이름에 공백이 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다.) |
Force |
선택 |
스위치 매개 변수 |
변경 작업을 수행하기 전에 표시되는 확인 메시지가 표시되지 않도록 합니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 개체입니다. 음성 경로 개체의 파이프라인된 입력을 허용합니다.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 유형의 개체를 제거합니다.
예제
-------------------------- 예제 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
ID가 Route1인 음성 경로에 대한 설정을 제거합니다.
-------------------------- 예제 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
이 명령은 조직에서 모든 음성 경로를 제거합니다. 먼저 Get-CsVoiceRoute cmdlet에 의해 모든 음성 경로가 검색됩니다. 그런 다음, 이러한 음성 경로는 각 음성 경로를 제거하는 Remove-CsVoiceRoute에 파이프됩니다.
-------------------------- 예제 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
이 명령은 문자열 "Redmond"를 포함하는 ID를 가진 모든 음성 경로를 제거합니다. 먼저 Get-CsVoiceRoute cmdlet이 Filter 매개 변수와 함께 호출됩니다. Filter 매개 변수 값은 문자열이 Identity 내의 아무 곳에나 위치할 수 있다는 것을 지정하는 와일드카드 문자(*)로 둘러싸인 문자열 Redmond입니다. 문자열 Redmond를 포함하는 ID를 가진 모든 음성 경로가 검색되고 나면 이러한 음성 경로는 각 음성 경로를 제거하는 Remove-CsVoiceRoute에 파이프됩니다.