New-CsPresencePolicy
마지막으로 수정된 항목: 2012-03-25
사이트 범위 또는 사용자별 범위에서 새 현재 상태 정책을 만듭니다.
구문
New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
자세한 정보
현재 상태 정보는 대화 상대가 인스턴트 메시징 대화에 참여할 수 있는지를 알려 주는 매우 유용한 정보입니다. 하지만 이와 동시에 현재 상태 정보와 관련하여 발생하는 비용이 있습니다. 현재 상태 구독 수가 많아질수록 현재 상태 정보를 업데이트하는 데 더 많은 네트워크 대역폭을 할당해야 합니다. 네트워크 대역폭이 문제가 되는 경우 사용자당 허용되는 현재 상태 구독 수를 제한할 수 있습니다.
CsPresencePolicy cmdlet을 사용하면 현재 상태 구독의 중요한 두 가지 요소인 프롬프트 구독자 및 범주 구독을 관리할 수 있습니다. 사용자가 다른 사람의 Microsoft Lync 2010 대화 상대 목록에 추가되면 기본적으로 이 목록에 추가되었음을 알리는 팝업 메시지가 나타납니다. 팝업을 해제할 때까지 각 알림에서 프롬프트 구독자로 간주합니다. 현재 상태 정책의 MaxPromptedSubscriber 속성을 사용하면 한 사용자에게 허용되는 확인되지 않은 알림 대화 상자의 최대 개수를 지정할 수 있습니다. 최대 개수에 도달하면 일부 대화 상자를 확인할 때까지 새 대화 상대 알림을 받을 수 없습니다.
범주 구독은 특정 범주의 정보에 대한 요청을 나타냅니다. 예를 들어 일정 데이터를 요청하는 응용 프로그램이 여기에 해당합니다. MaxCategorySubscription 속성을 통해 관리자는 한 사용자에게 허용되는 범주 구독 수를 제한할 수 있습니다.
Microsoft Lync Server 2010 버전 이전에는 프롬프트 구독자와 범주 구독을 전역적으로 관리했습니다. 하지만 이제는 CsPresencePolicy cmdlet을 사용하여 이러한 현재 상태 구독을 글로벌 범위, 사이트 범위 또는 사용자별 범위에서 관리할 수 있습니다. 이렇게 하면 대역폭 사용을 제어하는 동시에 사용자가 작업을 수행하는 데 필요한 현재 상태 정보에 액세스하도록 할 수 있습니다.
New-CsPresencePolicy cmdlet을 사용하면 사이트 범위 또는 사용자별 범위에서 사용자 지정 현재 상태 정책을 만들 수 있습니다. 사이트 범위에서 만든 정책은 해당 사이트에 자동으로 적용되지만 사용자별 범위에서 만든 정책은 Grant-CsPresencePolicy cmdlet을 실행하여 사용자에게 할당해야 합니다. 글로벌 범위에서 새 현재 상태 정책을 만들거나 개별 사이트에서 두 번째 현재 상태 정책을 만들 수는 없습니다. 예를 들어 Redmond 사이트는 현재 상태 정책을 하나만 호스팅할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsPresencePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsPresencePolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
Xds ID |
새 현재 상태 정책의 고유 식별자입니다. 새 사용자별 정책을 만들려면 -Identity "RedmondPresencePolicy"와 유사한 구문을 사용합니다. 사이트 범위에서 새 정책을 만들려면 -Identity "site:Redmond"와 유사한 구문을 사용합니다. 글로벌 범위에서 새 현재 상태 정책을 만들 수는 없습니다. 또한 해당 사이트에서 현재 상태 정책을 이미 호스팅 중이거나 이미 존재하는 사용자별 정책의 ID를 사용하려고 하면 명령이 실패합니다. |
|
Description |
선택 |
문자열 |
관리자가 현재 상태 정책과 함께 표시할 추가 텍스트를 제공하는 데 사용됩니다. 예를 들어 정책을 할당할 사용자에 대한 정보를 설명에 포함할 수 있습니다. |
MaxCategorySubscription |
선택 |
정수 |
한 번에 허용되는 최대 범주 구독 수입니다. 범주 구독은 특정 범주의 정보에 대한 요청을 나타냅니다. 예를 들어 일정 데이터를 요청하는 응용 프로그램이 여기에 해당합니다. MaxCategorySubscription은 0에서 3000 사이의 정수 값으로 설정할 수 있으며, 기본값은 1000입니다. |
MaxPromptedSubscriber |
선택 |
정수 |
사용자에게 한 번에 허용되는 최대 프롬프트 구독자 수입니다. 기본적으로 사용자가 다른 사용자의 대화 상대 목록에 추가될 때마다 사용자에게 이 사실을 알리고 상대방을 자신의 대화 상대 목록에 추가하거나 상대방이 자신의 현재 상태를 확인하지 못하게 차단하도록 선택할 수 있는 알림 대화 상자가 화면에 나타납니다. 작업을 수행하고 대화 상자를 취소할 때까지 각 알림에서 프롬프트 구독자로 간주합니다. MaxPromptedSubscriber는 0에서 600(포함) 사이의 정수 값으로 설정할 수 있으며, 기본값은 200입니다. 이 값을 0으로 설정하면 사용자가 다른 사용자의 대화 상대 목록에 추가될 때 알림이 제공되지 않습니다. |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. New-CsPresencePolicy는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
New-CsPresencePolicy는 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 개체의 새 인스턴스를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500
예제 1에 표시된 명령은 ID가 RedmondPresencePolicy인 새 사용자별 현재 상태 정책을 만듭니다. 이 예제에서는 MaxPromptedSubscriber 속성 값을 400으로 설정하고 MaxCategorySubscription 속성 값을 500으로 설정합니다.
-------------------------- 예제 2 --------------------------
$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x
예제 2에서는 처음에 새 사용자별 현재 상태 정책을 메모리에 만들고 나중에서야 실제 현재 상태 정책으로 변환합니다. 이 작업을 수행하기 위해 이 예제의 첫 번째 명령은 ID가 RedmondPresencePolicy인 현재 상태 정책을 만들고 이 정책을 $x라는 변수에 저장합니다. InMemory 매개 변수는 이 정책이 메모리에만 만들어지고 Lync Server 2010에 즉시 추가되지 않도록 합니다.
두 번째 및 세 번째 명령은 가상 정책의 MaxPromptedSubscriber 및 MaxCategorySubscription 속성을 구성하는 데 사용됩니다. 정책 값이 설정되면 넷째 줄에서 Set-CsPresencePolicy 및 Instance 매개 변수를 사용하여 $x에 저장된 정보를 기반으로 실제 현재 상태 정책을 만듭니다. 이 마지막 단계가 매우 중요합니다. Set-CsPresencePolicy를 호출하지 않으면 정책이 메모리에만 존재하고 Windows PowerShell 세션을 종료하거나 변수 $x를 삭제하는 즉시 사라집니다.