Get-AIPFileStatus

  • Referensi
Modul:
AzureInformationProtection

Mendapatkan label Information Protection Azure dan informasi perlindungan untuk file atau file tertentu.

Sintaks

Get-AIPFileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AIPFileStatus mengembalikan status Azure Information Protection dari file tertentu atau semua file dalam jalur tertentu. Status ini mencakup apakah file memiliki label, dan jika ya, nama label, siapa yang menerapkannya, cara penerapannya, dan kapan file tersebut diterapkan.

Jika file Anda disimpan di SharePoint Online, gunakan cmdlet Get-FileSensitivityLabelInfo dari modul SharePointOnlinePowerShell sebagai gantinya.

Status yang dikembalikan dalam cmdlet Get-AIPFileStatus juga menyertakan apakah file dilindungi oleh Rights Management, dan jika ya, templat Manajemen Hak apa yang digunakan untuk menerapkan perlindungan ini. Jika file dilindungi dengan izin kustom (kebijakan hak ad-hoc) alih-alih templat, "Akses Terbatas" ditampilkan alih-alih nama templat. Selain itu, pemilik Rights Management dan penerbit Rights Management ditampilkan, dan kapan file dilindungi.

Cmdlet ini mengembalikan informasi label dari penyewa Anda sendiri saja.

Perhatikan bahwa file yang dilindungi kata sandi selalu mengembalikan status perlindungan False.

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

Contoh

Contoh 1: Mendapatkan label dan status perlindungan dari satu file

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

Perintah ini menyediakan informasi tentang file yang dilabeli sebagai "Grup rahasia \ Keuangan", yang merupakan label yang dikonfigurasi untuk penyewa Anda. File ini diberi label secara manual oleh John dan juga dilindungi dengan menggunakan templat Manajemen Hak, "Contoso - Confidential Finance".

Contoh 2: Dapatkan label dan status perlindungan untuk semua file dalam folder dan ekspor hasilnya ke file CSV

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

Perintah ini mendapatkan informasi label dan perlindungan dari semua file di server Keuangan, di folder Proyek dan salah satu subfoldernya. Hasilnya diekspor ke file bernama AIP-status.csv sehingga dapat lebih mudah dicari dan diurutkan. Jika laporan sebelumnya ada di C:\Reports\Report.csv, laporan tersebut akan ditimpa.

Contoh 3: Mencantumkan file berlabel "Rahasia" dan mengekspor hasilnya ke file CSV

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv

Perintah ini mendapatkan informasi label dan perlindungan hanya untuk file yang diberi label "Rahasia" (terlepas dari sublabelnya) di server Keuangan, di folder Proyek dan subfoldernya. Hasilnya diekspor ke file bernama AIP-status.csv sehingga dapat lebih mudah dicari dan diurutkan. Jika laporan sebelumnya ada di C:\Reports\Report.csv, laporan tersebut akan ditimpa.

Contoh 4: Jumlah file dengan label "Rahasia"

PS C:\> (Get-AIPFileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Perintah ini menyediakan jumlah file dengan label "Rahasia" yang ada di folder C:\Projects dan salah satu subfoldernya. Dalam contoh ini, 5 file ditemukan.

Parameter

-Path

Menentukan jalur lokal, jalur jaringan, atau URL SharePoint Server ke file yang ingin Anda dapatkan label dan informasi perlindungannya. Kartu bebas 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

Input

System.String[]

Output

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult