Get-AipServiceDocumentLog

Azure Information Protection 추적되는 문서에 대한 보호 정보를 가져옵니다.

이 cmdlet은 아래 설명된 대로 Azure Information Protection 클래식 및 통합 레이블 지정 클라이언트에서 서로 다른 사용량으로 지원됩니다.

Syntax

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Get-AIPServiceDocumentLog cmdlet은 추적된 문서에 대한 보호 정보를 반환하는 쿼리를 실행합니다.

반환되는 정보에는 다음이 포함됩니다.

  • 사용할 수 있는 경우 문서 이름을 가진 문서 콘텐츠 ID입니다.
  • Rights Management 소유자 및 Rights Management 발급자입니다.
  • 액세스 권한이 부여된 사용자 및 그룹입니다.
  • 문서를 보호하는 보호 템플릿 ID 또는 특정 사용 권한입니다.
  • 만료, 오프라인 액세스 또는 해지 설정

포함시킬 항목의 시작 및 중지 시간을 지정할 수 있습니다. 출력은 PowerShell 콘솔에서 PowerShell 개체 목록으로 반환됩니다.

자세한 내용은 Rights Management 소유자 및 IRights 관리 발급자를 참조하세요.

통합 레이블 지정 클라이언트와 함께 사용하는 경우 쿼리는 문서 이름, 소유자 전자 메일 또는 둘 다를 기반으로 합니다.

다음 매개 변수 중 하나 이상을 지정해야 합니다.

  • ContentName
  • 소유자

ContentName 매개 변수를 사용하는 경우 FromTime 및 ToTime 매개 변수를 사용하여 콘텐츠를 특정 기간으로 필터링하는 것이 좋습니다.

예제

예제 1: (통합 레이블 지정 클라이언트만 해당) 특정 시간 범위에서 보호된 특정 파일 이름을 사용하여 추적된 모든 문서에 대한 보호 정보를 가져옵니다.

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

이 명령은 쿼리를 실행하고 2020년 12월에 보호된 파일 이름 test.docx사용하여 테넌트에 저장된 추적된 모든 문서에 대한 보호 정보를 반환합니다.

예제 2: (통합 레이블 지정 클라이언트만 해당) 특정 기간 동안 보호된 특정 파일 이름 및 소유자를 사용하여 추적된 모든 문서에 대한 보호 정보를 가져옵니다.

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

이 명령은 쿼리를 실행하고 다음 세부 정보와 일치하는 테넌트에 저장된 추적된 모든 문서에 대한 보호 정보를 반환합니다.

  • 파일 이름이 test.docx
  • 전자 메일을 사용하는 사용자가 파일을 보호했습니다. alice@contoso.com
  • 이 파일은 2020년 12월에 보호되었습니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentName

파일 확장명을 포함하여 추적된 문서의 전체 이름을 지정합니다.

통합 레이블 지정 클라이언트가 있는 경우 이 매개 변수 또는 Owner 매개 변수를 포함하거나 둘 다 포함할 수 있습니다.

이 매개 변수를 사용하는 경우 FromTimeToTime 날짜 필터를 사용하여 반환된 데이터를 필터링하는 것이 좋습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FromTime

로그 파일의 시작 시간(포함)을 DateTime 개체로 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다. 시스템 로캘 설정에 따라 날짜 및 시간을 지정합니다.

자세한 내용을 보려면 Get-Help Get-Date를 입력하십시오.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

문서를 보호한 사용자의 전자 메일 주소(Rights Management 발급자 또는 소유자)를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ToTime

로그 파일에 대한 중지 시간(포함)을 DateTime 개체로 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다. 시스템 로캘 설정에 따라 날짜 및 시간을 지정합니다.

자세한 내용을 보려면 Get-Help Get-Date를 입력하십시오.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False