Bagikan melalui


Set-FileLabel

Mengatur label sensitivitas dan perlindungan untuk file melalui pelabelan manual atau pelabelan otomatis sesuai dengan konfigurasi label atau izin kustom.

Sintaks

Set-FileLabel
   [-Path] <String[]>
   -LabelId <Guid>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]
Set-FileLabel
   [-Path] <String[]>
   -LabelId <Guid>
   [-JustificationMessage <String>]
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]
Set-FileLabel
   [-Path] <String[]>
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]
Set-FileLabel
   [-Path] <String[]>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-Force]
   [-PreserveFileDetails]
   [-AutoLabel]
   [<CommonParameters>]
Set-FileLabel
   [-Path] <String[]>
   [-PreserveFileDetails]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [<CommonParameters>]

Deskripsi

Untuk klien Perlindungan Informasi Microsoft Purview, cmdlet Set-FileLabel menetapkan 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-CustomPermissions .

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-FileLabel 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-FileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-FileLabel -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-FileStatus . 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-FileStatus | where {$_.IsLabeled -eq $False} | Set-FileLabel -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-FileStatus . 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-FileStatus.

Contoh 3: Terapkan label "Umum" ke semua file dalam folder dan salah satu subfoldernya

PS C:\> Set-FileLabel -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 salah satu 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 telah menghapus perlindungan.

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 pembenaran, file dilewati dengan komentar "Tidak ada label untuk diterapkan".

Contoh 4: Terapkan label "Umum" ke satu file, yang memerlukan pembenaran

PS C:\> Set-FileLabel -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 dengan label sensitivitas yang lebih tinggi. Kebijakan label sensitivitas dikonfigurasi untuk memerlukan pembenaran untuk menghapus label atau menurunkan klasifikasi. Karena perintah menyertakan pesan pembenaran, label baru berhasil diterapkan.

Contoh 5: Melindungi file dengan izin kustom

PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
PS C:\> Set-FileLabel 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 6: Menerapkan label dan izin kustom ke file

PS C:\> $permissions = New-CustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer 
PS C:\> Set-FileLabel 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 7: Pindai semua file dalam folder dan subfoldernya, dan terapkan label sesuai dengan kondisi yang dikonfigurasi untuk pelabelan otomatis

PS C:\> Set-FileLabel -AutoLabel -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 salah satu 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 isinya tidak cocok dengan kondisi yang dikonfigurasi untuk pelabelan otomatis Analysis.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 8: Pindai semua file dalam folder dan subfoldernya, dan terapkan label sesuai dengan kondisi yang dikonfigurasi untuk pelabelan otomatis, menimpa label yang ada

PS C:\> Set-FileLabel -Autolabel -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 ada tanpa label.

Contoh 9: Memindai file dalam mode WhatIf untuk semua jenis informasi sensitif yang diketahui

PS C:\> Set-FileLabel -AutoLabel -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 10: Memindai file dalam mode WhatIf untuk jenis informasi sensitif tertentu

PS C:\> Set-FileLabel -AutoLabel -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 11: Memindai file dalam mode WhatIf untuk jenis informasi sensitif tertentu dan menampilkan nilai yang ditemukan

PS C:\> $x=Set-FileLabel -AutoLabel -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 tertentu dari "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 pemrosesan lebih lanjut.

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

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

Parameter

-AutoLabel

Ketika -AutoLabel digunakan, cmdlet berjalan dalam mode pelabelan otomatis. Ketika cmdlet -AutoLabel tidak digunakan, berjalan dalam mode pelabelan manual.

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

-CustomPermissions

Menentukan nama variabel yang menyimpan kebijakan perlindungan ad-hoc, yang dibuat dengan menggunakan cmdlet New-CustomPermissions . 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

-DiscoveryInfoTypes

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[]
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 sensitivitas 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. Saat label memiliki sublabel, selalu tentukan ID hanya sublabel dan bukan label induk.

Untuk menemukan ID label:

Nilai ID label tidak ditampilkan dalam portal kepatuhan Microsoft Purview. 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-FileStatus untuk mengidentifikasi ID label (MainLabelId atau SubLabelId).

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

-Owner

Menentukan pemilik untuk menerapkan label atau perlindungan ke file.

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 label dan informasi perlindungannya.

Kartubebas tidak didukung dan lokasi WebDav tidak didukung.

Untuk jalur SharePoint, berikut ini didukung:

  • SharePoint Server 2022
  • 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 yang dimodifikasi (Windows dan SharePoint) dan diubah 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

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

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