Set-CsPresencePolicy

구문

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

자세한 정보

현재 상태 정보는 대화 상대가 인스턴트 메시징 대화에 참여할 수 있는지를 알려 주는 매우 유용한 정보입니다. 하지만 이와 동시에 현재 상태 정보와 관련하여 발생하는 비용이 있습니다. 현재 상태 구독 수가 많아질수록 현재 상태 정보를 업데이트하는 데 더 많은 네트워크 대역폭을 할당해야 합니다. 네트워크 대역폭이 문제가 되는 경우 사용자당 허용되는 현재 상태 구독 수를 제한할 수 있습니다.

CsPresencePolicy cmdlet을 사용하면 현재 상태 구독의 중요한 두 가지 요소인 프롬프트 구독자 및 범주 구독을 관리할 수 있습니다. 사용자가 다른 사람의 Microsoft Lync 2010 대화 상대 목록에 추가되면 기본적으로 이 목록에 추가되었음을 알리는 팝업 메시지가 나타납니다. 팝업을 해제할 때까지 각 알림에서 프롬프트 구독자로 간주합니다. 현재 상태 정책의 MaxPromptedSubscriber 속성을 사용하면 한 사용자에게 허용되는 확인되지 않은 알림 대화 상자의 최대 개수를 지정할 수 있습니다. 최대 개수에 도달하면 일부 대화 상자를 확인할 때까지 새 대화 상대 알림을 받을 수 없습니다.

범주 구독은 특정 범주의 정보에 대한 요청을 나타냅니다. 예를 들어 일정 데이터를 요청하는 응용 프로그램이 여기에 해당합니다. MaxCategorySubscription 속성을 통해 관리자는 한 사용자에게 허용되는 범주 구독 수를 제한할 수 있습니다.

Microsoft Lync Server 2010 버전 이전에는 프롬프트 구독자와 범주 구독을 전역적으로 관리했습니다. 하지만 이제는 CsPresencePolicy cmdlet을 사용하여 이러한 현재 상태 구독을 글로벌 범위, 사이트 범위 또는 사용자별 범위에서 관리할 수 있습니다. 이렇게 하면 대역폭 사용을 제어하는 동시에 사용자가 작업을 수행하는 데 필요한 현재 상태 정보에 액세스하도록 할 수 있습니다.

Set-CsPresencePolicy cmdlet을 통해 조직에서 사용하도록 구성된 모든 현재 상태 정책을 수정할 수 있습니다. 현재 상태 정책의 수정은 단순히 MaxPromptedSubscriber 속성 및/또는 MaxCategorySubscription 속성의 값을 변경하는 것을 의미합니다.

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

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

매개 변수

입력 형식

Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 개체입니다. Set-CsPresencePolicy는 현재 상태 정책 개체의 파이프라인된 입력을 허용합니다.

반환 형식

Set-CsPresencePolicy는 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 개체의 기존 인스턴스를 수정합니다.

예제

-------------------------- 예제 1 ------------------------

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

예제 1에 표시된 명령은 사용자별 현재 상태 정책 RedmondPresencePolicy를 수정합니다. 이 예제에서는 MaxPromptedSubscriber 속성의 값이 300으로 설정됩니다.

-------------------------- 예제 2 ------------------------

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

예제 2에 표시된 명령은 예제 1에 표시된 명령의 변형이지만, 이 경우 조직에서 사용하도록 구성된 모든 현재 상태 정책에 대해 MaxPromptedSubscriber 속성이 300으로 설정됩니다. 이 작업을 수행하기 위해 먼저 매개 변수 없이 Get-CsPresencePolicy를 호출합니다. 그러면 조직에서 사용하도록 구성된 모든 현재 상태 정책 컬렉션이 반환됩니다. 이 컬렉션은 컬렉션에 포함된 각 정책의 MaxPromptedSubscriber 값을 300으로 변경하는 Set-CsPresencePolicy에 파이프됩니다.

-------------------------- 예제 3 ------------------------

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

예제 3에서는 300명을 초과하는 프롬프트 구독자를 허용하는 정책이 없도록 조직의 현재 상태 정책을 구성하는 방법을 보여 줍니다. 이 작업을 수행하기 위해 먼저 매개 변수 없이 Get-CsPresencePolicy를 호출하여 조직의 모든 현재 상태 정책 컬렉션을 반환합니다. 이 컬렉션은 MaxPromptedSubscriber 정책 값이 300보다 큰 정책만 선택하는 Where-Object cmdlet에 파이프됩니다. 그런 다음 필터링된 컬렉션은 컬렉션의 각 정책에 대해 최대 프롬프트 구독자 수를 300명으로 설정하는 Set-CsPresencePolicy에 파이프됩니다. 그러면 일부 정책에서 300명 미만인 구독자를 허용할 수 있지만 어떤 정책에서도 300명이 넘는 프롬프트 구독자 수는 허용하지 않게 됩니다.

참고 항목

기타 리소스

Get-CsPresencePolicy
Grant-CsPresencePolicy
New-CsPresencePolicy
Remove-CsPresencePolicy