Get-CsVoicePolicy

 

마지막으로 수정된 항목: 2017-03-28

조직에 대해 구성된 하나 이상의 음성 정책에 대한 정보를 반환합니다. 이 cmdlet은 Lync Server 2010에서 도입되었습니다.

Get-CsVoicePolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsVoicePolicy [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

이 예제에서는 조직에 대해 정의된 모든 음성 정책을 각각에 대한 설정과 함께 표시합니다.

Get-CsVoicePolicy

이 예제에서는 Identity 매개 변수를 사용하여 UserPolicy1이라는 사용자별 정책에 대한 음성 정책 설정을 검색합니다.

Get-CsVoicePolicy -Identity UserPolicy1

이 예제에서는 Filter 매개 변수를 사용하여 사용자에게 할당할 수 있는 모든 음성 정책 설정을 검색합니다. 모든 사용자별 음성 정책은 tag:<UserVoicePolicy> 형식의 Identity를 가지므로 태그를 필터링하여 모든 사용자 음성 정책을 검색합니다.

Get-CsVoicePolicy -Filter tag*

이 cmdlet은 음성 정책 정보를 검색합니다. 음성 정책은 동시 벨 울림(누군가가 사무실 전화에 전화를 걸 때마다 또 다른 전화에서 벨이 울리는 기능) 및 착신 전환과 같은 Enterprise Voice 관련 기능을 관리하는 데 사용됩니다. 이 cmdlet을 사용하여 이러한 대부분의 기능을 활성화 및 비활성화하는 설정을 검색합니다.

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

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

 

매개 변수 필수 유형 설명

Filter

선택

System.String

이 매개 변수에는 와일드카드 문자열이 허용되며 해당 문자열과 일치하는 ID를 가진 모든 음성 정책이 반환됩니다. 예를 들어, Filter 값 site:*는 사이트 수준에서 정의된 모든 음성 정책을 반환합니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

정책의 범위나 경우에 따라서는 이름을 지정하는 고유한 식별자입니다. 이 매개 변수가 생략된 경우 조직의 모든 음성 정책이 반환됩니다.

LocalStore

선택

System.Management.Automation.SwitchParameter

중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 음성 정책을 검색합니다.

Tenant

선택

System.Guid

해당 음성 정책을 검색할 비즈니스용 Skype 온라인 테넌트 계정의 GUID(Globally Unique Identifier)입니다. 예를 들면 다음과 같습니다.

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

다음 명령을 실행하여 각 테넌트에 대해 테넌트 ID를 반환할 수 있습니다.

Get-CsTenant | Select-Object DisplayName, TenantID

Windows PowerShell의 원격 세션을 사용 중이고 비즈니스용 Skype 온라인에만 연결되는 경우 Tenant 매개 변수를 포함하지 않아도 됩니다. 대신, 연결 정보에 따라 테넌트 ID가 자동으로 채워집니다. Tenant 매개 변수는 하이브리드 배포에서 주로 사용됩니다.

없음.

이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 개체의 인스턴스를 반환합니다.

 
표시: