Invoke-CsQoEDatabasePurge

Skype for Business Server 2015
 

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

QoE(체감 품질) 데이터베이스에서 레코드를 수동으로 제거합니다. 이 cmdlet은 Lync Server 2013에서 도입되었습니다.

Invoke-CsQoEDatabasePurge -Identity <XdsIdentity> <COMMON PARAMETERS>
Invoke-CsQoEDatabasePurge -SqlServerFqdn <String> [-SqlInstanceName <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: -PurgeQoEDataOlderThanDays <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

예제 1에 표시된 명령은 atl-sql-001.litwareinc.com에 있는 모니터링 데이터베이스에서 10일보다 오래된 모든 QoE 레코드를 제거합니다.

Invoke-CsQoEDatabasePurge -Identity "service:MonitoringDatabase:atl-sql-001.litwareinc.com" -PurgeQoEDataOlderThanDays 10

예제 2에 표시된 명령은 예제 1에 표시된 명령의 변형으로, 이 경우에는 다음 구문을 사용하여 Confirm 매개 변수가 추가됩니다.

-Confirm:$False

해당 구문은 QoE 레코드 제거 시 일반적으로는 표시되는 확인 메시지를 표시하지 않습니다.

Invoke-CsQoEDatabasePurge -Identity "service:MonitoringDatabase:atl-sql-001.litwareinc.com" -PurgeQoEDataOlderThanDays 10 -Confirm:$False

예제 3에서는 조직에서 사용 중인 모든 모니터링 QoE 데이터베이스에서 10일보다 오래된 QoE 레코드를 모두 제거합니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 Get-CsService cmdlet 및 MonitoringDatabase 매개 변수를 사용하여 모든 모니터링 데이터베이스의 컬렉션을 반환하며, 이 컬렉션은 ForEach-Object cmdlet에 파이프됩니다. ForEach-Object cmdlet은 컬렉션의 각 데이터베이스를 가져온 다음 해당 데이터베이스에 대해 Invoke-CsQoEDatabasePurge cmdlet을 실행하여 10일보다 오래된 모든 체감 품질 레코드를 제거합니다.

Get-CsService -MonitoringDatabase | Invoke-CsQoEDatabasePurge -PurgeQoEDataOlderThanDays 10 -Confirm:$False

QoE(체감 품질) 메트릭은 손실된 네트워크 패킷 수, 백그라운드 노이즈, "지터"(패킷 지연의 차이) 크기 등 조직의 오디오 및 비디오 통화 품질을 추적합니다. 이러한 메트릭은 통화 정보 기록과 같은 기타 데이터와 별도로 데이터베이스에 저장되므로 다른 데이터 기록에 관계없이 QoE를 설정 및 해제할 수 있습니다.

체감 품질 레코드는 SQL Server 데이터베이스 LcsQoEMetrics에 저장됩니다. 시간이 지남에 따라 이 데이터베이스는 매우 커질 수 있으므로, Lync Server에서는 관리자가 오래된 레코드를 데이터베이스에서 제거하는 두 가지 방법을 제공합니다 그 중 하나는 매일 오래된 QoE 레코드를 자동으로 삭제하도록 비즈니스용 Skype 서버 2015를 구성하는 것이고, 다른 하나는 언제든지 Invoke-CsQoEDatabasePurge cmdlet을 사용하여 LcsQoEMetrics 데이터베이스에서 체감 품질 레코드를 삭제하는 것입니다. Invoke-CsQoEDatabasePurge cmdlet은 SQL Server 저장 프로시저 QoePurgeOutdatedReports를 호출하여 이 작업을 수행합니다.

Invoke-CsQoEDatabasePurge cmdlet을 호출할 때는 QoE 레코드가 저장된 모니터링 데이터베이스의 서비스 위치를 지정해야 합니다(예: MonitoringDatabase:atl-sql-001.litwareinc.com). 또한 삭제할 레코드의 최소 기간을 일 단위로 지정해야 합니다. 예를 들어 최소 기간을 10일로 지정하면 10일보다 오래된 모든 QoE 레코드가 데이터베이스에서 삭제됩니다.

이러한 레코드는 지정한 데이터베이스에 대해 제거를 사용하지 않도록 설정한 경우(QoE 구성 설정에서 EnablePurging 속성이 False로 설정된 경우)에도 삭제됩니다. EnablePurging 속성은 자동화된 보관 레코드 제거만 제어하며, Invoke-CsQoEDatabasePurge cmdlet에는 아무런 영향을 주지 않습니다.

사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 반환하려면 Windows PowerShell 명령줄 인터페이스 프롬프트에서 다음 명령을 실행합니다.

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

비즈니스용 Skype 서버 제어판: Invoke-CsQoEDatabasePurge cmdlet에 의해 수행되는 기능은 비즈니스용 Skype 서버 제어판에서 사용할 수 없습니다.

 

매개 변수 필수 유형 설명

Identity

필수

Microsoft.Rtc.Management.Xds.XdsIdentity

제거할 모니터링 데이터베이스의 서비스 ID입니다. 다음 명령을 실행하면 모니터링 데이터베이스의 ID를 검색할 수 있습니다.

Get-CsService –MonitoringDatabase

Identity 매개 변수와 SqlServerFqdn 매개 변수를 같은 명령에 사용할 수는 없습니다.

PurgeQoEDataOlderThanDays

필수

System.Int32

데이터베이스에서 제거할 QoE 레코드의 시간을 일 단위로 지정합니다.

PurgeQoEDataOlderThanHours는 1에서 2147483647(포함) 사이의 정수 값으로 설정할 수 있습니다.

SqlServerFqdn

필수

System.String

QoE 데이터베이스가 있는 컴퓨터의 정규화된 도메인 이름입니다. 예를 들면 다음과 같습니다.

-SqlServerFqdn "atl-sql-001.litwareinc.com"

Identity 매개 변수와 SqlServerFqdn 매개 변수를 같은 명령에 사용할 수는 없습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

Force

선택

System.Management.Automation.SwitchParameter

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

SqlInstanceName

선택

System.String

QoE 데이터베이스의 SQL Server 인스턴스 이름입니다. 예를 들면 다음과 같습니다.

-SqlInstanceName "archinst"

WhatIf

선택

System.Management.Automation.SwitchParameter

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

Invoke-CsQoEDatabasePurge cmdlet은 Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase#Decorated 클래스의 파이프라인된 인스턴스를 허용합니다.

Invoke-CsQoEDatabasePurge cmdlet은 Microsoft.Rtc.Management.Purge.QoEDataPurgeStatistics 클래스의 인스턴스를 반환합니다.

 
표시: