Set-AIPFileLabel

Referensi

Modul:: AzureInformationProtection

Mengatur atau menghapus label Azure Information Protection untuk file, dan mengatur atau menghapus perlindungan sesuai dengan konfigurasi label atau izin kustom.

Sintaks

Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-PreserveFileDetails]
   [-EnableTracking]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Deskripsi

Untuk klien pelabelan terpadu AIP, cmdlet Set-AIPFileLabel mengatur atau menghapus label sensitivitas untuk satu atau beberapa file. Tindakan ini dapat secara otomatis menerapkan perlindungan ketika label dikonfigurasi untuk menerapkan enkripsi.

Selain itu, Anda dapat menggunakan cmdlet ini untuk menerapkan izin kustom saat dibuat sebagai objek kebijakan perlindungan ad-hoc dengan cmdlet New-AIPCustomPermissions .

Ketika perintah berhasil dijalankan, label atau perlindungan yang ada dapat diganti.

Anda dapat menjalankan cmdlet ini secara non-interaktif. Untuk informasi selengkapnya, lihat Panduan admin klien pelabelan terpadu.

Catatan

Saat menjalankan cmdlet Set-AIPFileLabel dalam perulangan, tambahkan dua baris ini setelah cmdlet: [GC]::Collect()
[GC]::WaitForPendingFinalizers()

Contoh

Contoh 1: Terapkan label "Umum" ke semua file yang saat ini tidak memiliki label

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -LabelId d9f23ae3-4321-4321-4321-f515f824c57b
FileName                              Status Comment
--------                              ------ ------------
\\Finance\Projects\Image.jpg          Success
\\Finance\Projects\Pricelist.pdf      Success
\\Finance\Projects\Announcement.docx  Success
\\Finance\Projects\Analysis.xlsx      Success

Perintah ini pertama-tama mengidentifikasi semua file yang tidak diberi label dengan menggunakan cmdlet Get-AIPFileStatus . Kemudian, file-file ini diberi label dengan menentukan label "Umum" dengan ID-nya.

Contoh 2: Terapkan label "Umum" ke file .docx yang tidak diberi label

PS C:\> Get-ChildItem C:\Projects\*.docx -File -Recurse | Get-AIPFileStatus | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b
FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

Perintah ini pertama-tama mengidentifikasi semua file .docx di folder C:\Projects (dan subfoldernya) dengan menggunakan Get-Child-Item, lalu menemukan dari file-file ini yang tidak diberi label dengan menggunakan cmdlet Get-AIPFileStatus . File yang dihasilkan kemudian diberi label dengan menentukan label "Umum" dengan ID-nya.

Catatan

Perintah ini menggunakan alias Jalur FullName, sehingga Get-Child-Item dapat digunakan dengan Get-AIPFileStatus.

Contoh 3: (Hanya klien pelabelan terpadu) Terapkan label "Umum" ke semua file dalam folder dan subfoldernya

PS C:\> Set-AIPFileLabel -Path C:\Projects\ -LabelId d9f23ae3-1324-1234-1234-f515f824c57b
FileName                    Status      Comment
--------                    ------      ------------
C:\Projects\Project1.docx   Success
C:\Projects\Datasheet.pdf   Success
C:\Projects\Image.jpg       Success
C:\Projects\Analysis.xlsx   Skipped    No label to apply
C:\Projects\Dashboard.xlsx  Success

Perintah ini mengatur label bernama "Umum" pada semua file di folder Proyek dan subfoldernya.

Jika label Umum dikonfigurasi untuk menerapkan enkripsi, file yang berhasil diberi label dengan perintah ini juga akan dienkripsi. Dalam hal ini, pemilik Manajemen Hak (yang memiliki izin Kontrol Penuh Manajemen Hak) dari file-file ini adalah pengguna yang menjalankan perintah PowerShell.

Dalam contoh ini, satu file tidak diberi label (dilewati) karena memerlukan pembenaran. Ini mungkin hasil yang dimaksudkan untuk memastikan bahwa file dengan label klasifikasi atau perlindungan yang lebih tinggi tidak secara tidak sengaja ditimpa dengan label klasifikasi yang lebih rendah atau memiliki perlindungan yang dihapus.

Untuk mengaktifkan perlindungan ini, kebijakan label klasifikasi Office 365 harus dikonfigurasi untuk memerlukan pembenaran untuk menghapus label atau menurunkan klasifikasi. Ketika Anda kemudian menjalankan perintah ini tanpa parameter JustificationMessage dan label memicu justifikasi, file dilewati dengan komentar "Tidak ada label untuk diterapkan".

Contoh 4: (Hanya klien pelabelan terpadu) Terapkan label "Umum" ke satu file, yang memerlukan pembenaran

PS C:\> Set-AIPFileLabel -Path \\Finance\Projects\Analysis.xlsx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -JustificationMessage 'The previous label no longer applies'
FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

Perintah ini mengatur label "Umum" untuk file yang sudah diberi label klasifikasi yang lebih tinggi. Kebijakan label klasifikasi Office 365 dikonfigurasi untuk memerlukan pembenaran untuk menghapus label atau menurunkan klasifikasi. Karena perintah menyertakan pesan justifikasi, label baru berhasil diterapkan.

Contoh 5: (Hanya klien pelabelan terpadu) Hapus label dari file

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Perintah ini menghapus label yang ada dari file bernama C:\Projects\Analysis.docx, dan menentukan pesan pertimbangan wajib.

Metode pembenaran ini diperlukan karena pengaturan kebijakan label klasifikasi Office 365 yang relevan diaktifkan untuk memerlukan pembenaran untuk menghapus label atau menurunkan klasifikasi.

Catatan

Jika label yang Anda hapus melindungi file Anda menggunakan templat, perintah ini akan menghapus label dan perlindungan.

Jika label yang Anda hapus melindungi file Anda menggunakan izin kustom, perintah ini hanya menghapus label.

Contoh 6: (Hanya klien pelabelan terpadu) Lindungi file dengan izin kustom

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Perintah pertama membuat objek kebijakan perlindungan ad-hoc yang memberi pengguna hak penggunaan organisasi yang berbeda dari izin Peninjau, dan juga menerapkan tanggal kedaluwarsa.

Perintah kedua melindungi satu file bernama Analysis.docx dengan menggunakan izin kustom di objek kebijakan perlindungan ad-hoc yang disimpan.

Contoh 7: (Hanya klien pelabelan terpadu) Terapkan label dan izin kustom ke file

PS C:\> $permissions = New-AIPCustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer 
PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Perintah pertama membuat objek kebijakan perlindungan ad-hoc yang memberi pengguna hak penggunaan organisasi yang berbeda dari izin Peninjau, dan juga menerapkan tanggal kedaluwarsa.

Perintah kedua menerapkan label ke satu file bernama Analysis.docx dan juga melindungi file dengan menggunakan izin kustom di objek kebijakan perlindungan ad-hoc yang disimpan. Jika label dikonfigurasi untuk pengaturan perlindungan, label digantikan oleh izin kustom.

Contoh 8: (Hanya klien pelabelan terpadu) Hapus perlindungan dari file

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Perintah ini menghapus perlindungan dari satu file bernama Analysis.docx.

Contoh 9: (Hanya klien pelabelan terpadu) Hapus perlindungan dan label dari file

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Perintah ini menghapus label dan perlindungan kustom dari satu file bernama Analysis.docx. Karena kebijakan dikonfigurasi untuk mengharuskan pembenaran untuk menghapus label, alasan pembenaran juga disediakan sehingga perintah dapat diselesaikan tanpa meminta pengguna karena alasan tersebut.

Parameter

-CustomPermissions

Menentukan nama variabel yang menyimpan kebijakan perlindungan ad-hoc, yang dibuat dengan menggunakan cmdlet New-AIPCustomPermissions . Kebijakan perlindungan ad-hoc digunakan untuk melindungi file atau file dengan izin kustom.

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

-EnableTracking

Tentukan parameter ini untuk mendaftarkan dokumen yang dilindungi dengan portal pelacakan dokumen.

Pengguna yang menjalankan cmdlet ini dan administrator global kemudian dapat melacak dokumen yang dilindungi dan jika perlu, mencabutnya. Untuk informasi selengkapnya tentang situs pelacakan dokumen, lihat Mengonfigurasi dan menggunakan pelacakan dokumen untuk Azure Information Protection dari panduan admin.

Jika label tidak menerapkan perlindungan, parameter ini diabaikan.

Type:	SwitchParameter
Position:	named
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JustificationMessage

Alasan pembenaran untuk menurunkan label klasifikasi, menghapus label, atau menghapus perlindungan, jika kebijakan Azure Information Protection mengharuskan pengguna untuk memberikan informasi ini. Jika pengaturan label memicu pembenaran dan alasan ini tidak disediakan, label tidak diterapkan. Dalam hal ini, status yang dikembalikan adalah "Dilewati" dengan komentar "Pembenaran diperlukan".

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

-LabelId

Menentukan identitas (ID) label yang akan diterapkan. Ketika label memiliki sublabel, selalu tentukan ID hanya sublabel dan bukan label induk.

Untuk menemukan ID label:

Nilai ID label tidak ditampilkan di pusat Kepatuhan Microsoft 365. Namun, Anda dapat menggunakan perintah PowerShell Pusat Kepatuhan & Keamanan Office 365 berikut ini untuk menemukan nilai ini:Get-Label | Format-Table -Property DisplayName, Name, Guid

Untuk file yang memiliki label yang diterapkan, Anda juga dapat menjalankan cmdlet Get-AIPFileStatus untuk mengidentifikasi ID label (MainLabelId atau SubLabelId).

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

-Path

Menentukan jalur lokal, jalur jaringan, atau URL SharePoint Server ke file yang ingin Anda dapatkan informasi label dan perlindungannya.

Kartubebas tidak didukung dan lokasi WebDav tidak didukung.

Untuk jalur SharePoint, berikut ini didukung:

SharePoint Server 2019
SharePoint Server 2016
SharePoint Server 2013

Contohnya:

C:\Folder\
C:\Folder\Filename
\\Server\Folder
http://sharepoint.contoso.com/Shared%20Documents/Folder

Jalur dapat menyertakan spasi saat Anda mengapit nilai jalur dengan tanda kutip.

Type:	String[]
Aliases:	FullName, FileName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PreserveFileDetails

Tentukan parameter ini untuk membiarkan tanggal yang dimodifikasi (Windows dan SharePoint) dan dimodifikasi oleh nilai (SharePoint) tidak berubah untuk dokumen yang Anda beri label:

Untuk file lokal atau jaringan, nilai Tanggal diubah tetap tidak berubah.
Untuk file SharePoint, tanggal Diubah dan Diubah oleh nilai tetap tidak berubah.

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

-RemoveLabel

Menghapus label apa pun yang telah diterapkan ke file.

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

-RemoveProtection

Relevan untuk: Klien pelabelan terpadu saja

Menghapus perlindungan dari file. Jika file diberi label, label tidak dihapus.

Anda harus memiliki hak penggunaan yang memadai atau menjadi pengguna super bagi organisasi Anda untuk menghapus perlindungan dari file. Untuk informasi selengkapnya, lihat Mengonfigurasi pengguna super untuk Azure Rights Management dan layanan penemuan atau pemulihan data.

Gunakan cmdlet PowerShell Set-AIPFileLabel untuk mengaktifkan penghapusan perlindungan dari file kontainer (zip, .rar, .7z, dan .pst).

Catatan

Kemampuan perlindungan penghapusan ini dinonaktifkan secara default dan harus terlebih dahulu diaktifkan menggunakan cmdlet Set-LabelPolicy .
Untuk file .pst, 5 GB adalah ukuran file maksimum yang didukung dengan cmdlet ini.

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

Input

System.String[]

Output

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Set-AIPFileLabel

Sintaks

Deskripsi

Contoh

Contoh 1: Terapkan label "Umum" ke semua file yang saat ini tidak memiliki label

Contoh 2: Terapkan label "Umum" ke file .docx yang tidak diberi label

Contoh 3: (Hanya klien pelabelan terpadu) Terapkan label "Umum" ke semua file dalam folder dan subfoldernya

Contoh 4: (Hanya klien pelabelan terpadu) Terapkan label "Umum" ke satu file, yang memerlukan pembenaran

Contoh 5: (Hanya klien pelabelan terpadu) Hapus label dari file

Contoh 6: (Hanya klien pelabelan terpadu) Lindungi file dengan izin kustom

Contoh 7: (Hanya klien pelabelan terpadu) Terapkan label dan izin kustom ke file

Contoh 8: (Hanya klien pelabelan terpadu) Hapus perlindungan dari file

Contoh 9: (Hanya klien pelabelan terpadu) Hapus perlindungan dan label dari file

Parameter

-CustomPermissions

-EnableTracking

-JustificationMessage

-LabelId

-Path

-PreserveFileDetails

-RemoveLabel

-RemoveProtection

Input

Output

Link Terkait

Sumber Daya Tambahan: