다음을 통해 공유

Get-RMSFileStatus

  • 참조
모듈:
AzureInformationProtection

지정된 파일의 RMS 보호 상태를 가져옵니다.

구문

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

Description

Get-RMSFileStatus cmdlet은 지정된 파일의 보호 상태(파일이 Rights Management로 보호되는지 여부)를 반환합니다.

보호된 파일의 상태는 보호됨(네이티브) 또는 보호됨(제네릭)이며 보호되지 않은 파일의 상태는 보호되지 않습니다.

Outlook 데이터 파일(예: 고유하게 보호된 컨테이너 파일)을 확인합니다. PST)는 항상 보호되지 않는 보호 상태를 반환합니다.

예제

예제 1: 지정된 파일의 보호 상태 나열

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

이 명령은 지정된 파일 C:\Test.docx대한 Rights Management 보호 상태를 나열합니다.

.docx 파일 이름 확장명을 가진 파일은 네이티브 보호를 지원하므로 상태는 "보호됨(네이티브)" 또는 "보호되지 않음"을 반환합니다.

예제 2: 폴더의 모든 파일 및 하위 폴더에 대한 보호 상태 나열

PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}

Get-RMSFileStatus cmdlet은 한 번에 하나의 파일에 대해 작동하지만 다음 Windows PowerShell 명령을 사용하여 폴더(예: C:\Documents)와 해당 하위 폴더에 있는 모든 파일의 상태를 가져올 수 있습니다.

드라이브 및 경로 대신 UNC 경로와 동일한 명령을 사용할 수 있습니다.

예제 3: 폴더의 모든 파일 및 하위 폴더에 대한 보호 상태가 있는 .CSV 파일 만들기

PS C:\>$(foreach ($file in (Get-ChildItem -Path C:\Documents\ -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}) | Export-Csv -Path C:\Temp\ProtectedFilesList.csv -Encoding ascii -NoTypeInformation

정보를 정렬하고 정렬할 수 있도록 결과를 .CSV 파일로 출력하여 이전 예제를 추가로 확장할 수 있습니다.

이 예제에서 .CSV 파일의 이름은 ProtectedFilesList.csvC:\Temp 폴더에 저장됩니다. 파일이 이미 있으면 덮어씁니다.

매개 변수

-File

파일의 정규화된 경로를 지정하여 권한 관리로 보호되는지 여부를 확인합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False