Bagikan melalui

Unprotect-RMSFile

  • Referensi
Modul:
AzureInformationProtection

Membatalkan perlindungan file yang saat ini dilindungi oleh RMS.

Sintaks

Unprotect-RMSFile
         [-File <String>]
         [-Folder <String>]
         [-InPlace]
         [-Recurse]
         [-OutputFolder <String>]
         [-SupressUI]
         [-LogFile <String>]
         [-ProcessContainers]
         [<CommonParameters>]

Deskripsi

Cmdlet Unprotect-RMSFile menghapus perlindungan Rights Management (RMS) dari satu atau beberapa file dalam folder tertentu jika file tersebut sebelumnya dilindungi oleh AD RMS atau Azure RMS.

Anda harus memiliki hak penggunaan yang memadai atau menjadi pengguna super bagi organisasi Anda untuk membuka proteksi file. Untuk informasi selengkapnya, lihat Mengonfigurasi pengguna super untuk Azure Information Protection dan layanan penemuan atau pemulihan data.

Jika Anda tidak melindungi file kontainer, setiap anak diekstraksi, tidak terlindungi, dan dikemas ulang secara rekursif. Jenis file kontainer yang didukung .zip, .rar, .7z, .msg, dan .pst.

Untuk file .pst , 5 GB adalah ukuran file maksimum yang didukung dengan cmdlet ini.

Saat Menjalankan cmdlet ini, Anda memiliki opsi berikut:

  • File tidak terlindungi dalam folder yang sama sehingga file asli yang dilindungi dan file baru yang tidak terlindungi berdampingan.

  • File asli tetap dilindungi dan versi file yang tidak terlindungi dibuat di lokasi lain.

  • Semua file dalam folder yang ditentukan tidak terlindungi di lokasi saat ini, menggantikan file asli yang dilindungi.

  • Semua file dalam folder yang ditentukan tetap dilindungi dan versi yang tidak terlindungi dari setiap file dibuat di lokasi lain.

Anda dapat menjalankan perintah ini secara bersamaan saat Menentukan jalur yang berbeda untuk parameter LogFile untuk setiap perintah yang berjalan secara paralel. Jika Anda tidak menentukan jalur file log yang berbeda dan perintah sebelumnya belum selesai, perintah baru akan gagal.

Contoh

Contoh 1: Membuka proteksi satu file, menggantikan file asli

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -InPlace
InputFile         DecryptedFile
---------         -------------
C:\Test.ptxt      C:\ Test.txt

Perintah ini membuka proteksi satu file bernama Test.ptxt, mengganti versi file yang dilindungi ini dengan versi yang tidak terlindungi di lokasi yang sama. Ketika direktori output tidak disediakan dan parameter InPlace ditentukan, file sumber diganti.

Contoh 2: Membuka proteksi satu file, mempertahankan file asli

PS C:\>Unprotect-RMSFile -File "C:\Test.ptxt" -OutputFolder "C:\Temp"
InputFile       DecryptedFile
---------       -------------
C:\Test.ptxt    C:\Temp\Test.txt

Perintah ini membuka proteksi satu file tetapi mempertahankan file asli yang dilindungi dengan membuat versi yang tidak terlindungi di lokasi folder bernama C:\Temp. Saat folder output disediakan, nama file unik dibuat untuk file yang tidak terlindungi. Jika file dengan nama yang sama ada, nama file baru dibuat unik dengan cara yang sama seperti File Explorer membuat salinan unik dengan nama file yang sama. Misalnya, jika Test.txt ada, Copy.txtPengujian dibuat, maka Uji Salin(2).txt.

Contoh 3: Membuka proteksi folder

PS C:\>Unprotect-RMSFile -Folder "C:\Protected" -OutputFolder "C:\Temp"
InputFile                  DecryptedFile
---------                  -------------
C:\Protected\Test.ptxt     C:\Temp\Protected\Test.txt

C:\Protected\Word.docx     C:\Temp\Protected\Word.docx

Perintah ini membuka proteksi folder, mempertahankan file asli yang dilindungi dan membuat versi yang tidak terlindungi di lokasi folder bernama C:\Temp dan membuat subfolder "Dilindungi" yang sesuai.

Perintah ini juga dapat digunakan dengan parameter Recurse , yang menentukan apakah akan menyertakan pemrosesan subfolder.

Contoh 4: Buka proteksi . File PST

PS C:\>Unprotect-RMSFile -File "C:\Test.pst" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.pst   C:\Temp\Test.pst

Perintah ini membuka proteksi file .pst (Tabel Penyimpanan Pribadi), yang merupakan file kontainer yang dapat menyimpan file .msg Microsoft Outlook.

Pada gilirannya, file .msg ini dapat menjadi kontainer yang menyimpan lampiran. Karena file .pst adalah kontainer, setiap file anak dan kontainer berlapis juga tidak terlindungi oleh operasi ini.

Contoh 5: Membuka proteksi file .RAR

PS C:\>Unprotect-RMSFile -File "C:\Test.rar" -OutputFolder "C:\Temp"
InputFile     DecryptedFile
---------     -------------
C:\Test.rar   C:\Temp\Test.zip

Perintah ini membuka proteksi file arsip .rar . Karena file.rar adalah file kontainer yang menyimpan file berlapis, file berlapis ini juga dapat berupa arsip. Setiap file anak dan kontainer berlapis juga tidak terlindungi oleh operasi ini.

Perhatikan bahwa untuk file input .rar , file yang tidak terlindungi adalah file .zip .

Parameter

-File

Menentukan jalur dan file yang tidak terlindungi. Untuk jalur, Anda dapat menentukan huruf kandar atau UNC.

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

-Folder

Menentukan jalur dan folder yang tidak terlindungi. Semua file dalam folder yang ditentukan tidak akan terlindungi.

Untuk jalur, Anda dapat menentukan huruf kandar atau UNC.

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

-InPlace

File atau file dalam folder yang ditentukan tidak terlindungi di lokasi saat ini, menggantikan file atau file asli yang dilindungi. Parameter ini diabaikan jika parameter OutputFolder ditentukan.

Jika Tidak ada InPlace maupun OutputFolder yang ditentukan, file baru dibuat di direktori saat ini dengan "-Copy" ditambahkan ke nama file, menggunakan konvensi penamaan yang sama yang File Explorer gunakan saat file disalin dan ditempelkan ke folder yang sama. Misalnya, jika file dengan Document.docx dilindungi, versi yang tidak terlindungi diberi nama Document-Copy.docx. Jika file bernama Document-Copy.docx sudah ada, Document-Copy(2).docx dibuat, dan sebagainya.

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

-LogFile

Menentukan jalur dan nama file dasar, dengan ekstensi nama file opsional untuk file log. File log ini mencantumkan file yang berhasil atau tidak berhasil dilindungi. Tiga file log berikut dibuat untuk keberhasilan, kegagalan, dan debug masing-masing:

  • <nama> file.< ekstensi nama file>

  • <kegagalan nama> file.< ekstensi nama file>

  • <nama> file-debug.< ekstensi nama file>

Untuk file kontainer, file log ini juga menyertakan file berlapis.

Misalnya, jika Anda menentukan C:\Users\Administrator\Unprotect-RMSFile.txt untuk parameter ini, file log berikut dibuat:

  • Untuk file yang berhasil tidak terlindungi: C:\Users\Administrator\Unprotect-RMSFile.txt

  • Untuk file apa pun yang tidak dapat dilindungi: C:\Users\Administrator\Unprotect-RMSFile-failure.txt

  • Untuk informasi debug: C:\Users\Administrator\Unprotect-RMSFile-debug.txt

Untuk jalur, Anda dapat menentukan huruf kandar atau UNC.

Jika Anda tidak menentukan parameter ini, file log Success.log, Failure.log, dan Debug.log ditulis ke lokasi file log default %localappdata%\Microsoft\MSIPC\pscmdlet\Logs[GUID].

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

-OutputFolder

Menentukan folder output untuk versi file yang tidak terlindungi. Struktur folder asli dipertahankan, yang berarti bahwa subfolder mungkin dibuat untuk nilai yang Anda tentukan.

Untuk jalur, Anda dapat menggunakan huruf kandar atau UNC.

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

-ProcessContainers

Parameter ini saat ini tidak diimplementasikan.

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

-Recurse

Menunjukkan bahwa operasi ini tidak melindungi semua file di semua subfolder.

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

-SupressUI

Parameter ini tidak diimplementasikan; tidak ada UI untuk cmdlet ini.

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