Get-CsVoicePolicy
마지막으로 수정된 항목: 2012-03-23
조직에 대해 구성된 하나 이상의 음성 정책에 대한 정보를 반환합니다.
구문
Get-CsVoicePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoicePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
이 cmdlet은 음성 정책 정보를 검색합니다. 음성 정책은 동시 벨 울림(누군가가 사무실 전화에 전화를 걸 때마다 또 다른 전화에서 벨이 울리는 기능) 및 착신 전환과 같은 Enterprise Voice 관련 기능을 관리하는 데 사용됩니다. 이 cmdlet을 사용하여 이러한 대부분의 기능을 활성화 및 비활성화하는 설정을 검색합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsVoicePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoicePolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
정책의 범위나 경우에 따라서는 이름을 지정하는 고유한 식별자입니다. 이 매개 변수가 생략된 경우 조직의 모든 음성 정책이 반환됩니다. |
Filter |
선택 |
문자열 |
이 매개 변수에는 와일드카드 문자열이 허용되며 해당 문자열과 일치하는 ID를 가진 모든 음성 정책이 반환됩니다. 예를 들어, Filter 값 site:*는 사이트 수준에서 정의된 모든 음성 정책을 반환합니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 음성 정책을 검색합니다. |
입력 형식
없음.
반환 형식
이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsVoicePolicy
이 예제에서는 조직에 대해 정의된 모든 음성 정책을 각각에 대한 설정과 함께 표시합니다.
-------------------------- 예제 2 --------------------------
Get-CsVoicePolicy -Identity UserPolicy1
이 예제에서는 Identity 매개 변수를 사용하여 UserPolicy1이라는 사용자별 정책에 대한 음성 정책 설정을 검색합니다.
-------------------------- 예제 3 --------------------------
Get-CsVoicePolicy -Filter tag*
이 예제에서는 Filter 매개 변수를 사용하여 사용자에게 할당할 수 있는 모든 음성 정책 설정을 검색합니다. 모든 사용자별 음성 정책은 tag:<UserVoicePolicy> 형식의 Identity를 가지므로 태그를 필터링하여 모든 사용자 음성 정책을 검색합니다.