Get-FileStatus

Sözdizimi

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

Description

Get-FileStatus cmdlet'i, belirtilen bir dosyanın veya belirtilen yoldaki tüm dosyaların 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-FileStatus 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.

Örnekler

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

PS C:\> Get-FileStatus -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-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.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 Report.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-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.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 Report.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-FileStatus -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

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult

İlişkili Bağlantılar

• Set-Authentication
• Set-FileLabel