Get-FileStatus

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

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

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

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

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

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

비대화형으로 이 cmdlet을 실행할 수 있습니다.

PS C:\> Get-FileStatus -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

이 명령은 테넌트에 대해 구성된 레이블인 "Confidential \ Finance group"으로 레이블이 지정된 파일에 대한 정보를 제공합니다. 이 파일은 John이 수동으로 레이블을 지정했으며 권한 관리 템플릿 "Contoso - Confidential Finance"를 사용하여 보호됩니다.

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

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

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

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

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

5

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

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.