New-CsPresencePolicy

 

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

사이트 범위 또는 사용자별 범위에서 새 현재 상태 정책을 만듭니다. 이 cmdlet은 Lync Server 2010에서 도입되었습니다.

New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

예제 1에 표시된 명령은 ID가 RedmondPresencePolicy인 새 사용자별 현재 상태 정책을 만듭니다. 이 예제에서는 MaxPromptedSubscriber 속성 값을 400으로 설정하고 MaxCategorySubscription 속성 값을 500으로 설정합니다.

New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500

예제 2에서는 처음에 새 사용자별 현재 상태 정책을 메모리에 만들고 나중에서야 실제 현재 상태 정책으로 변환합니다. 이 작업을 수행하기 위해 이 예제의 첫 번째 명령은 ID가 RedmondPresencePolicy인 현재 상태 정책을 만들고 이 정책을 $x라는 변수에 저장합니다. InMemory 매개 변수는 이 정책이 메모리에만 만들어지고 비즈니스용 Skype 서버 2015에 즉시 추가되지 않도록 합니다.

두 번째 및 세 번째 명령은 가상 정책의 MaxPromptedSubscriber 및 MaxCategorySubscription 속성을 구성하는 데 사용됩니다. 정책 값이 설정되면 넷째 줄에서 Set-CsPresencePolicy cmdlet 및 Instance 매개 변수를 사용하여 $x에 저장된 정보를 기반으로 실제 현재 상태 정책을 만듭니다. 이 마지막 단계가 매우 중요합니다. Set-CsPresencePolicy cmdlet을 호출하지 않으면 정책이 메모리에만 존재하고 Windows PowerShell 세션을 종료하거나 변수 $x를 삭제하는 즉시 사라집니다.

$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x

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

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

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

Lync Server 버전 이전에는 프롬프트 구독자와 범주 구독을 전역적으로 관리했습니다. 하지만 이제는 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

필수

Microsoft.Rtc.Management.Xds.XdsIdentity

새 현재 상태 정책의 고유 식별자입니다. 새 사용자별 정책을 만들려면 -Identity "RedmondPresencePolicy"와 유사한 구문을 사용합니다. 사이트 범위에서 새 정책을 만들려면 -Identity "site:Redmond"와 유사한 구문을 사용합니다.

전역 범위에서 새 현재 상태 정책을 만들 수는 없습니다. 또한 해당 사이트에서 현재 상태 정책을 이미 호스트 중이거나 이미 존재하는 사용자별 정책의 ID를 사용하려고 하면 명령이 실패합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

명령을 실행하기 전에 확인 메시지를 표시합니다.

Description

선택

System.String

관리자가 현재 상태 정책과 함께 표시할 추가 텍스트를 제공하는 데 사용됩니다. 예를 들어 정책을 할당할 사용자에 대한 정보를 설명에 포함할 수 있습니다.

Force

선택

System.Management.Automation.SwitchParameter

명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다.

InMemory

선택

System.Management.Automation.SwitchParameter

개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set-<cmdlet>을 호출하여 해당 변경 사항을 커밋할 수 있습니다.

MaxCategorySubscription

선택

System.UInt16

한 번에 허용되는 최대 범주 구독 수입니다. 범주 구독은 특정 범주의 정보에 대한 요청을 나타냅니다. 예를 들어 일정 데이터를 요청하는 응용 프로그램이 여기에 해당합니다.

MaxCategorySubscription은 0에서 3000 사이의 정수 값으로 설정할 수 있으며, 기본값은 1000입니다.

MaxPromptedSubscriber

선택

System.UInt16

사용자에게 한 번에 허용되는 최대 프롬프트 구독자 수입니다. 기본적으로 사용자가 다른 사용자의 대화 상대 목록에 추가될 때마다 사용자에게 이 사실을 알리고 상대방을 자신의 대화 상대 목록에 추가하거나 상대방이 자신의 현재 상태를 확인하지 못하게 차단하도록 선택할 수 있는 알림 대화 상자가 화면에 나타납니다. 작업을 수행하고 대화 상자를 취소할 때까지 각 알림에서 프롬프트 구독자로 간주합니다.

MaxPromptedSubscriber는 0에서 600(포함) 사이의 정수 값으로 설정할 수 있으며, 기본값은 200입니다. 이 값을 0으로 설정하면 사용자가 다른 사용자의 대화 상대 목록에 추가될 때 알림이 제공되지 않습니다.

Tenant

선택

System.Guid

새 현재 상태 정책이 만들어지는 비즈니스용 Skype 온라인 테넌트 계정의 GUID(Globally Unique Identifier)입니다. 예를 들면 다음과 같습니다.

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

다음 명령을 실행하여 비즈니스용 Skype 온라인 테넌트 각각에 대한 테넌트 ID를 반환할 수 있습니다.

Get-CsTenant | Select-Object DisplayName, TenantID

WhatIf

선택

System.Management.Automation.SwitchParameter

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

없음. New-CsPresencePolicy cmdlet은 파이프라인된 입력을 허용하지 않습니다.

New-CsPresencePolicy cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 개체의 새 인스턴스를 만듭니다.

 
표시: