Bagikan melalui

Get-RMSFileStatus

  • Referensi
Modul:
AzureInformationProtection

Mendapatkan status perlindungan RMS dari file tertentu.

Sintaks

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

Deskripsi

Cmdlet Get-RMSFileStatus mengembalikan status perlindungan (apakah file dilindungi oleh Rights Management atau tidak) dari file tertentu.

File yang dilindungi memiliki status Dilindungi (Asli) atau Dilindungi (Generik), dan file yang tidak terlindungi memiliki status Tidak Terlindungi.

Perhatikan bahwa file kontainer yang dilindungi secara asli, seperti file data Outlook (. PST) selalu mengembalikan status perlindungan Tidak Terlindungi.

Contoh

Contoh 1: Mencantumkan status perlindungan untuk file tertentu

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

Perintah ini mencantumkan status perlindungan Manajemen Hak untuk file yang ditentukan C:\Test.docx.

Karena file dengan ekstensi nama file.docx mendukung perlindungan asli, status mengembalikan "Dilindungi (Asli)" atau "Tidak Terlindungi".

Contoh 2: Mencantumkan status perlindungan untuk semua file dalam folder dan subfolder apa pun

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

Meskipun cmdlet Get-RMSFileStatus berfungsi untuk satu file pada satu waktu, Anda dapat menggunakan perintah Windows PowerShell berikut untuk mendapatkan status semua file dalam folder (dalam contoh kami, bernama C:\Documents) dan subfoldernya.

Perintah yang sama dapat digunakan dengan jalur UNC alih-alih drive dan jalur.

Contoh 3: Membuat file .CSV dengan status perlindungan untuk semua file dalam folder dan subfolder apa pun

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

Anda dapat memperluas contoh sebelumnya lebih lanjut dengan mengeluarkan hasilnya ke file .CSV, sehingga Anda dapat mengurutkan dan mengurutkan informasi.

Dalam contoh ini, file .CSV diberi nama ProtectedFilesList.csv dan disimpan ke folder C:\Temp . Jika file sudah ada, itu akan ditimpa.

Parameter

-File

Menentukan jalur yang sepenuhnya memenuhi syarat ke file untuk memverifikasi apakah jalur tersebut dilindungi oleh Manajemen Hak.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False