다음을 통해 공유

Get-AIPFileStatus

  • 참조
모듈:
AzureInformationProtection

지정된 파일 또는 파일에 대한 Azure Information Protection 레이블 및 보호 정보를 가져옵니다.

구문

Get-AIPFileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Description

Get-AIPFileStatus cmdlet은 지정된 파일의 Azure Information Protection 상태 또는 지정된 경로의 모든 파일을 반환합니다. 이 상태에는 파일에 레이블이 있는지 여부, 레이블 이름, 적용한 사람, 적용 방법 및 시기가 포함됩니다.

파일이 SharePoint Online에 저장된 경우 SharePointOnlinePowerShell 모듈에서 Get-FileSensitivityLabelInfo cmdlet을 대신 사용합니다.

Get-AIPFileStatus cmdlet에 반환된 상태에는 파일이 Rights Management에 의해 보호되는지 여부와 보호되는 경우 이 보호를 적용하는 데 사용된 Rights Management 템플릿이 포함됩니다. 파일이 템플릿 대신 사용자 지정 권한(임시 권한 정책)으로 보호된 경우 템플릿 이름 대신 "제한된 액세스"가 표시됩니다. 또한 Rights Management 소유자 및 Rights Management 발급자가 표시되고 파일이 보호된 경우도 표시됩니다.

이 cmdlet은 사용자 고유의 테넌트에서만 레이블 정보를 반환합니다.

암호로 보호된 파일은 항상 False의 보호 상태를 반환합니다.

이 cmdlet을 비대화형으로 실행할 수 있습니다. 자세한 내용은 통합 레이블 지정 클라이언트 관리자 가이드를 참조하세요.

예제

예제 1: 단일 파일의 레이블 및 보호 상태 가져오기

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

이 명령은 테넌트에 대해 구성된 레이블인 "기밀 \ 재무 그룹"으로 레이블이 지정된 파일에 대한 정보를 제공합니다. 이 파일은 John에 의해 수동으로 레이블이 지정되었으며 Rights Management 템플릿 "Contoso - 기밀 재무"를 사용하여 보호됩니다.

예제 2: 폴더에 있는 모든 파일에 대한 레이블 및 보호 상태를 가져오고 결과를 CSV 파일로 내보냅니다.

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

이 명령은 Finance 서버, Projects 폴더 및 해당 하위 폴더에 있는 모든 파일의 레이블 및 보호 정보를 가져옵니다. 결과를 더 쉽게 검색하고 정렬할 수 있도록 AIP-status.csv 파일로 내보냅니다. 이전 보고서가 C:\Reports\Report.csv있는 경우 덮어씁니다.

예제 3: "기밀"이라는 레이블이 지정된 파일을 나열하고 결과를 CSV 파일로 내보냅니다.

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv

이 명령은 Finance 서버, Projects 폴더 및 해당 하위 폴더에서 "기밀"(해당 하위 레이블에 관계 없이)으로 레이블이 지정된 파일에 대한 레이블 및 보호 정보를 가져옵니다. 결과를 더 쉽게 검색하고 정렬할 수 있도록 AIP-status.csv 파일로 내보냅니다. 이전 보고서가 C:\Reports\Report.csv있는 경우 덮어씁니다.

예제 4: "기밀" 레이블이 있는 파일 수

PS C:\> (Get-AIPFileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

이 명령은 C:\Projects 폴더 및 해당 하위 폴더에 있는 "기밀" 레이블이 있는 파일 수를 제공합니다. 이 예제에서는 5개의 파일을 찾습니다.

매개 변수

-Path

레이블 및 보호 정보를 가져올 파일에 대한 로컬 경로, 네트워크 경로 또는 SharePoint Server URL을 지정합니다. 와일드카드는 지원되지 않습니다.

SharePoint 경로의 경우 다음이 지원됩니다.

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

다음은 그 예입니다.

경로 값을 따옴표로 묶을 때 경로에 공백이 포함될 수 있습니다.

형식:String[]
별칭:FullName, FileName
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

System.String[]

출력

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult