Get-CsArchivingPolicy

구문

Get-CsArchivingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsArchivingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

자세한 정보

대부분의 조직에서는 조직의 사용자가 참가하는 모든 IM 세션을 보관하는 것이 유용하다는 것을 인지하고 있습니다. 다른 조직의 경우 법적으로 IM 세션을 보관해야 하기도 합니다. Microsoft Lync Server 2010을 사용하여 IM 세션을 보관하려면 두 가지 단계를 수행해야 합니다. 먼저 Set-CsArchivingConfiguration cmdlet을 사용하여 글로벌 및/또는 사이트 범위에서 보관을 설정해야 합니다. 이렇게 하면 IM 세션을 보관할 수 있지만 자동으로 이러한 세션의 보관이 시작되지는 않습니다.

IM 세션의 대화 내용을 실제로 저장하려면 2단계: 하나 이상의 IM 세션 보관 정책 만들기를 수행해야 합니다. 이러한 정책은 IM 세션이 기록되는 사용자와 보관할 IM 세션 유형(내부 및/또는 외부)을 결정합니다. 내부 IM 세션은 모든 참가자가 조직 내에 Active Directory 계정이 있는 인증된 사용자인 세션입니다. 외부 IM 세션은 참가자 중 한 명 이상이 조직 내에 Active Directory 계정이 없는 인증되지 않은 사용자인 세션입니다. 내부 세션만 보관하거나, 외부 세션만 보관하거나, 내부 및 외부 세션을 모두 보관할 수 있습니다.

New-CsArchivingPolicy cmdlet을 사용하여 만든 보관 정책을 글로벌 사이트나 사이트 범위에 할당할 수 있습니다. 이러한 정책을 사용자별 범위에 할당할 수도 있으며, 이 경우 정책을 만든 다음 특정 사용자나 특정 사용자 집합에 적용할 수 있습니다. 예를 들어 모든 사용자에 대해 내부 IM 세션을 보관하는 글로벌 정책이 있을 수 있습니다. 또한 내부 및 외부 세션을 모두 보관하는 두 번째 정책을 만들고 해당 정책을 영업 사원에게만 적용할 수 있습니다. 사용자별 정책이 글로벌 및 사이트 정책보다 우선하므로 영업 팀 구성원의 모든 IM 세션이 보관됩니다. 다른 사용자(즉, 영업 부서에 속하지 않으므로 영업 정책의 영향을 받지 않는 사용자)는 내부 IM 세션만 보관됩니다.

Get-CsArchivingPolicy cmdlet을 통해 조직에서 사용하도록 구성된 보관 정책에 대한 정보를 반환할 수 있습니다. 이러한 정책은 글로벌 또는 사이트 범위에서 IM 세션 보관이 설정된 경우에만 적용됩니다. IM 세션 보관이 설정되었는지 여부를 확인하려면 Get-CsArchivingConfiguration cmdlet을 사용합니다.

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

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

매개 변수

입력 형식

없음. Get-CsArchivingPolicy는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

Get-CsArchivingPolicy는 Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy 개체의 인스턴스를 반환합니다.

예제

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

Get-CsArchivingPolicy

예제 1에서는 매개 변수 없이 Get-CsArchivingPolicy를 호출합니다. 이를 통해 조직에서 현재 사용 중인 모든 보관 정책 컬렉션을 반환합니다.

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

Get-CsArchivingPolicy -Identity site:Redmond

예제 2에서는 Get-CsArchivingPolicy를 사용하여 Identity가 site:Redmond인 보관 정책을 반환합니다. ID가 고유해야 하므로 이 명령은 항상 최대 한 개 정책을 반환합니다.

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

Get-CsArchivingPolicy -Filter tag:*

위 명령은 사용자별 범위에서 구성된 모든 보관 정책 컬렉션을 반환합니다. 이 작업을 수행하기 위해 Filter 매개 변수와 필터 값 "tag:*"가 포함됩니다. 이 필터 값을 지정하면 Get-CsArchivingPolicy에서 Identity가 문자열 값 "tag:"로 시작하는 정책만 반환합니다.

-------------------------- 예제 4 --------------------------

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}

예제 4에서는 내부 IM 세션의 보관이 비활성화된 모든 보관 정책 컬렉션을 반환합니다. 먼저 현재 사용 중인 모든 보관 정책 컬렉션을 반환하기 위해 Get-CsArchivingPolicy가 사용됩니다. 이 컬렉션은 Where-Object cmdlet에 파이프됩니다. Where-Object는 ArchiveInternal 속성이 False와 같은 정책에 대한 데이터만 반환되도록 제한하는 필터를 적용합니다.

-------------------------- 예제 5 --------------------------

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}

예제 5는 예제 4와 유사하지만 이 경우에는 명령에서 내부 및 외부 보관이 모두 비활성화된 모든 보관 정책을 반환합니다. 먼저 현재 사용 중인 모든 보관 정책 컬렉션을 반환하기 위해 Get-CsArchivingPolicy가 사용됩니다. 이 컬렉션은 ArchiveInternal 및 the ArchiveExternal 속성이 모두 False와 같은 정책만 선택하는 Where-Object에 파이프됩니다. -and 연산자는 지정한 조건을 모두 충족하는 정책만 선택하도록 Where-Object에 지시합니다. 지정된 조건 중 하나 또는 둘 다를 충족하는 정책을 선택하려면 –or 연산자를 사용합니다.

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}

참고 항목

기타 리소스

Grant-CsArchivingPolicy
New-CsArchivingPolicy
Remove-CsArchivingPolicy
Set-CsArchivingPolicy