Remove-CsVoicePolicy
마지막으로 수정된 항목: 2012-03-24
지정한 음성 정책을 제거합니다.
구문
Remove-CsVoicePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
자세한 정보
이 cmdlet은 기존 음성 정책을 제거합니다. 음성 정책은 동시 벨 울림(누군가가 사무실 전화에 전화를 걸 때마다 또 다른 전화에서 벨이 울리는 기능) 및 착신 전환과 같은 Enterprise Voice 관련 기능을 관리하는 데 사용됩니다. 또한 이 cmdlet을 사용하여 글로벌 음성 정책을 제거할 수 있습니다. 그러나 이 경우 정책은 실제로 제거되지 않으며 단순히 정책 설정이 기본값으로 다시 설정됩니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Remove-CsVoicePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoicePolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Xds ID |
제거할 정책의 범위나 경우에 따라서는 이름을 지정하는 고유한 식별자입니다. |
Force |
선택 |
스위치 매개 변수 |
변경하기 전에 표시되는 확인 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 개체입니다. 음성 정책 개체의 파이프라인된 입력을 허용합니다.
반환 형식
이 cmdlet은 값을 반환하지 않습니다. Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 개체의 인스턴스를 제거합니다.
예제
-------------------------- 예제 1 --------------------------
Remove-CsVoicePolicy -Identity UserVoicePolicy1
이 예제에서는 UserVoicePolicy1 사용자별 음성 정책 설정을 제거합니다.
-------------------------- 예제 2 --------------------------
Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy
이 예제에서는 특정 사용자에게 할당할 수 있는 모든 음성 정책 설정을 제거합니다. 먼저 Get-CsVoicePolicy cmdlet은 모든 사용자별 음성 정책을 검색하는 tag* 필터와 함께 호출됩니다. 그런 다음, 해당 정책 컬렉션은 제거할 Remove-CsVoicePolicy cmdlet에 파이프됩니다.