Set-AIPFileClassification

  • Referensi
Modul:
AzureInformationProtection

Memindai file untuk secara otomatis mengatur label Azure Information Protection untuk file, sesuai dengan kondisi yang dikonfigurasi dalam kebijakan.

Sintaks

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AIPFileClassification dapat secara otomatis menerapkan label untuk satu atau beberapa file saat Anda mengonfigurasi label untuk klasifikasi otomatis.

Ketika cmdlet ini dijalankan, cmdlet ini memeriksa konten file dan jika kondisi yang dikonfigurasi terpenuhi untuk label, label tersebut diterapkan. Tindakan ini akan secara otomatis menerapkan perlindungan jika label yang dipilih menerapkan perlindungan.

Secara default, jika file sudah memiliki label, label atau perlindungan yang ada tidak diganti.

Ketika file tidak diberi label karena diberi label secara manual, tidak ada kecocokan untuk kondisi yang Anda tentukan, atau file memiliki klasifikasi yang lebih tinggi, file dilewati dengan satu komentar "Tidak ada label untuk diterapkan".

Untuk informasi selengkapnya, lihat: Menerapkan label sensitivitas ke konten secara otomatis

Menjalankan cmdlet secara non-interaktif

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

Contoh

Contoh 1: Pindai semua file dalam folder dan subfoldernya, dan terapkan label sesuai dengan kondisi yang dikonfigurasi untuk klasifikasi otomatis

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Perintah ini memindai semua file di folder Proyek dan subfoldernya, dan mengatur label sesuai dengan kondisi yang dikonfigurasi dalam kebijakan pelabelan otomatis. Dalam contoh ini, ada lima file dan dua file secara otomatis diberi label. File Datasheet.pdf tidak diberi label karena kontennya tidak cocok dengan kondisi yang dikonfigurasi untuk klasifikasi otomatisAnalysis.xlsx sudah diberi label secara manual, dan Pricelist.xlsx memiliki label yang lebih tinggi. Karena perintah dijalankan tanpa parameter -Force , label yang ada untuk Analysis.xlsx dan Pricelist.xlsx tidak ditimpa.

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

Karena parameter PreserveFileDetails ditentukan, Tanggal Diubah dari file berlabel tetap tidak berubah.

Contoh 2: Pindai semua file dalam folder dan subfoldernya, dan terapkan label sesuai dengan kondisi yang dikonfigurasi untuk klasifikasi otomatis, menimpa label yang ada

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Perintah ini mirip dengan contoh sebelumnya karena juga memindai semua file di folder Proyek dan salah satu subfoldernya, dan mengatur label sesuai dengan kondisi yang dikonfigurasi untuk pelabelan otomatis. Namun, kali ini, karena perintah menyertakan parameter -Force , perintah ini juga menggantikan label yang ada untuk Dashboard.xlsx, dan Pricelist.xlsx.

Isi Datasheet.pdf tidak cocok dengan kondisi yang dikonfigurasi dan file ini tetap tanpa label.

Contoh 3: (Hanya klien pelabelan terpadu) Pindai file dalam mode WhatIf untuk semua jenis informasi sensitif yang diketahui

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

Perintah ini menemukan semua jenis informasi yang diketahui dalam file Project1.docx tanpa menerapkan perlindungan atau label.

Contoh 4: (Hanya klien pelabelan terpadu) Pindai file dalam mode WhatIf untuk jenis informasi sensitif tertentu

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

Perintah ini menemukan jenis informasi spesifik "Nomor Kartu Kredit", dan "Nomor Jaminan Sosial (SSN)" dalam file Project1.docx tanpa menerapkan perlindungan atau label.

Contoh 5: (Hanya klien pelabelan terpadu) Pindai file dalam mode WhatIf untuk jenis informasi sensitif tertentu dan tampilkan nilai yang ditemukan

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

Mirip dengan contoh sebelumnya, perintah pertama menemukan jenis informasi spesifik "Nomor Kartu Kredit", dan "Nomor Jaminan Sosial (SSN)" dalam file Project1.docx tanpa menerapkan perlindungan atau label. Namun, dalam contoh ini, hasilnya disimpan dalam variabel untuk diproses lebih lanjut.

Perintah kedua kemudian digunakan untuk menampilkan konten jenis informasi yang cocok, yang mencakup parameter SensitiveContents.

Perintah akhir menampilkan dan memformat agar lebih mudah membaca data yang diidentifikasi oleh jenis informasi sensitif pertama, yang dalam contoh ini, adalah detail kartu kredit.

Parameter

-DiscoveryInfoTypes

Catatan: Parameter ini hanya didukung dengan klien pelabelan terpadu Azure Information Protection.

Tentukan jenis informasi sensitif yang akan ditemukan saat Anda menggunakan parameter WhatIf .

Jika Anda ingin mencari jenis informasi sensitif tertentu, tentukan nomor Id entitas untuk jenis informasi tersebut, yang dapat Anda temukan tercantum dalam Jenis informasi sensitif di Server Exchange.

Misalnya, "50842eb7-edc8-4019-85dd-5a5c1f2bb085" adalah angka yang ditentukan untuk jenis informasi sensitif Nomor Kartu Kredit.

Type:String[]
Accepted values:All, "rule_id_1", "rule_id_2"
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Menggantikan label yang ada saat kondisi yang dikonfigurasi berlaku.

Type:SwitchParameter
Position:Named
Default value:None
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, bahkan jika parameter -Force diatur. Dalam hal ini, status yang dikembalikan adalah "Dilewati" dengan komentar berikut: "Tidak ada label untuk diterapkan"

Type:String
Position:Named
Default value:None
Required:False
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:

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 tidak berubah untuk dokumen yang Anda beri label.

Untuk file lokal atau jaringan, tanggal Terakhir Diubah tetap tidak berubah.

Untuk file SharePoint, tanggal Diubah dan Tanggal diubah Oleh tetap tidak berubah.

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

-WhatIf

Relevan untuk: Klien pelabelan terpadu saja

Menunjukkan apa yang akan terjadi jika cmdlet berjalan, dan setara dengan mode penemuan untuk pemindai. Perubahan tidak akan berlaku pada file input atau output.

Gunakan parameter ini dengan DiscoveryInfoTypes untuk mencari semua jenis informasi sensitif, atau jenis informasi sensitif tertentu.

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

Input

System.String[]

Output

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult