Get-CsPresencePolicy
마지막으로 수정된 항목: 2012-05-21
조직에서 사용하도록 구성된 현재 상태 정책에 대한 정보를 반환합니다.
구문
Get-CsPresencePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPresencePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
현재 상태 정보(이 정보를 통해 대화 상대가 인스턴트 메시징 대화에 참여할 수 있는지 여부를 알 수 있음)는 매우 유용합니다. 그러나 이와 동시에 현재 상태 정보에는 비용이 따릅니다. 즉, 현재 상태 구독이 많을수록 현재 상태를 업데이트하는 데 더 많은 네트워크 대역폭이 사용됩니다. 네트워크 대역폭을 관리해야 할 경우 사용자별로 현재 상태 구독의 수를 제한하는 것이 좋습니다.
CsPresencePolicy cmdlet을 사용하면 현재 상태 구독의 중요한 두 가지 요소인 프롬프트된 구독자와 범주 구독을 관리할 수 있습니다. 사용자가 다른 사람의 Microsoft Lync 2010 대화 상대 목록에 추가되면 기본적으로 이 목록에 추가되었음을 알리는 팝업 메시지가 나타납니다. 팝업을 해제할 때까지 각 알림에서 프롬프트 구독자로 간주합니다. 현재 상태 정책의 MaxPromptedSubscriber 속성을 사용하면 사용자별로 확인되지 않은 알림 대화 상자의 최대 수를 지정할 수 있습니다. 최대 수에 도달한 사용자는 적어도 이러한 대화 상자의 일부가 확인될 때까지는 새 대화 상대 알림을 받지 않습니다.
범주 구독은 예를 들어 일정 데이터를 요청하는 응용 프로그램과 같은 특정 정보 범주에 대한 요청을 나타냅니다. 관리자는 MaxCategorySubscription 속성을 사용하여 사용자별 범주 구독의 수를 제한할 수 있습니다.
Microsoft Lync Server 2010 버전 이전에는 프롬프트 구독자와 범주 구독을 전역적으로 관리했습니다. 하지만 이제는 CsPresencePolicy cmdlet을 사용하여 이러한 현재 상태 구독을 글로벌 범위, 사이트 범위 또는 사용자별 범위에서 관리할 수 있습니다. 이를 통해 사용자가 업무를 수행하는 데 필요한 현재 상태 정보에 액세스할 수 있도록 하는 동시에 대역폭도 제어할 수 있습니다.
Get-CsPresencePolicy cmdlet은 조직에서 사용하도록 구성된 모든 현재 상태 정책에 대한 정보를 반환할 수 있는 수단을 제공합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsPresencePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPresencePolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
검색할 현재 상태 정책의 고유 식별자입니다. 글로벌 정책을 반환하려면 -Identity global 구문을 사용합니다. 사이트 범위에 구성된 정책을 반환하려면 -Identity "site:Redmond" 형태의 구문을 사용합니다. 사용자별 범위에 구성된 정책을 반환하려면 -Identity "RedmondPresencePolicy" 형태의 구문을 사용합니다. Identity를 지정할 때 와일드카드 문자를 사용할 수 없습니다. Identity 또는 Filter 매개 변수 중 아무것도 지정되지 않은 경우 Get-CsPresencePolicy는 조직에서 사용자에 대해 구성된 모든 현재 상태 정책을 반환합니다. |
Filter |
선택 |
문자열 |
반환할 정책을 지정할 때 와일드카드를 사용할 수 있도록 합니다. 예를 들어 사이트 범위에서 구성된 모든 현재 상태 정책을 반환하려면 -Filter "site:*" 구문을 사용하고, Filter와 Identity 매개 변수를 같은 명령에서 사용할 수는 없습니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 현재 상태 정책 데이터를 검색합니다. |
입력 형식
없음. Get-CsPresencePolicy는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Get-CsPresencePolicy는 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsPresencePolicy
예제 1의 명령은 조직의 사용자에 대해 구성된 모든 현재 상태 정책에 대한 정보를 반환합니다. 이 작업은 Get-CsPresencePolicy를 매개 변수 없이 호출하여 수행합니다.
-------------------------- 예제 2 --------------------------
Get-CsPresencePolicy -Identity "RedmondPresencePolicy"
예제 2에서는 하나의 사용자별 현재 상태, 즉 Identity가 RedmondPresencePolicy인 정책을 반환합니다.
-------------------------- 예제 3 --------------------------
Get-CsPresencePolicy -Filter "site:*"
위 명령은 사이트 범위에 구성된 모든 현재 상태 정책에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 명령은 Filter 매개 변수 및 필터 값 "site:*"를 사용합니다. 이 필터 값은 반환되는 데이터를 Identity가 문자열 값 "site:"로 시작하는 모든 현재 상태 정책으로 제한합니다.
-------------------------- 예제 4 --------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}
예제 4에서는 프롬프트된 구독자의 최대 수가 100명 이하로 제한되는 모든 현재 상태 정책에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 명령에서는 먼저 매개 변수 없이 Get-CsPresencePolicy를 호출하여 조직에서 사용하도록 구성된 모든 현재 상태 정책 컬렉션을 반환합니다. 그러면 이 컬렉션은 MaxPromptedSubscriber 속성이 100보다 작거나 같은 정책만 선택하는 Where-Object cmdlet에 파이프됩니다.