Get-AIPFileStatus

  • Başvuru
Modül:
AzureInformationProtection

Belirtilen dosya veya dosyalar için Azure Information Protection etiket ve koruma bilgilerini alır.

Syntax

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

Description

Get-AIPFileStatus cmdlet'i, belirtilen bir dosyanın veya belirtilen yoldaki tüm dosyaların Azure Information Protection durumunu döndürür. Bu durum, dosyanın etiketi olup olmadığını ve varsa etiket adını, bunu kimin uyguladığını, nasıl uygulandığını ve ne zaman uygulandığını içerir.

Dosyalarınız SharePoint Online'da depolanıyorsa, bunun yerine SharePointOnlinePowerShell modülündeki Get-FileSensitivityLabelInfo cmdlet'ini kullanın.

Get-AIPFileStatus cmdlet'inde döndürülen durum, dosyanın Rights Management tarafından korunup korunmadığını ve korunuyorsa, bu korumayı uygulamak için hangi Rights Management şablonunun kullanıldığını da içerir. Dosya şablon yerine özel izinlerle (geçici bir hak ilkesi) korunuyorsa, şablon adı yerine "Kısıtlı Erişim" görüntülenir. Buna ek olarak, Rights Management sahibi ve Rights Management vereni ve dosyanın ne zaman korunduğu görüntülenir.

Bu cmdlet yalnızca kendi kiracınızdan etiket bilgilerini döndürür.

Parola korumalı dosyaların her zaman False koruma durumunu döndürdüğünü unutmayın.

Bu cmdlet'i etkileşimli olmayan bir şekilde çalıştırabilirsiniz. Daha fazla bilgi için birleşik etiketleme istemcisi yönetici kılavuzuna bakın.

Örnekler

Örnek 1: Tek bir dosyanın etiket ve koruma durumunu alma

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

Bu komut, kiracınız için yapılandırılmış bir etiket olan "Gizli \ Finans grubu" olarak etiketlenmiş bir dosya hakkında bilgi sağlar. Bu dosya John tarafından el ile etiketlendi ve "Contoso - Gizli Finans" Rights Management şablonu kullanılarak da korunuyor.

Örnek 2: Bir klasördeki tüm dosyalar için etiket ve koruma durumunu alma ve sonuçları CSV dosyasına aktarma

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

Bu komut, Finance sunucusundaki tüm dosyaların etiket ve koruma bilgilerini Projeler klasöründe ve alt klasörlerinden herhangi birinde alır. Sonuçlar, daha kolay aranabilmeleri ve sıralanmaları için AIP-status.csv adlı dosyaya aktarılır. C:\Reports\Report.csviçinde önceki bir rapor varsa, üzerine yazılır.

Örnek 3: "Gizli" etiketli dosyaları listeleyin ve sonuçları CSV dosyasına aktarın

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

Bu komut, Finance sunucusundaki Projeler klasöründe ve alt klasörlerinden herhangi birinde yalnızca "Gizli" (alt etiketlerinden bağımsız olarak) etiketlenmiş dosyalar için etiket ve koruma bilgilerini alır. Sonuçlar, daha kolay aranabilmeleri ve sıralanmaları için AIP-status.csv adlı dosyaya aktarılır. C:\Reports\Report.csviçinde önceki bir rapor varsa, üzerine yazılır.

Örnek 4: "Gizli" etiketli dosyaların sayısı

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

5

Bu komut , C:\Projects klasöründe ve alt klasörlerinden herhangi birinde bulunan "Gizli" etiketine sahip dosya sayısını sağlar. Bu örnekte 5 dosya bulunur.

Parametreler

-Path

Etiket ve koruma bilgilerini almak istediğiniz dosyaların yerel yolunu, ağ yolunu veya SharePoint Server URL'sini belirtir. Joker karakterler desteklenmez.

SharePoint yolları için aşağıdakiler desteklenir:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Örnek:

Yol değerini tırnak içine aldığınızda yollar boşluk içerebilir.

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

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult