Get-FileStatus

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

Polecenie cmdlet Get-FileStatus zwraca stan określonego pliku lub wszystkich plików w określonej ścieżce. Ten stan obejmuje to, czy plik ma etykietę, a jeśli tak, nazwę etykiety, kto ją zastosował, jak została zastosowana i kiedy.

Jeśli pliki są przechowywane w usłudze SharePoint Online, zamiast tego użyj polecenia cmdlet Get-FileSensitivityLabelInfo z modułu SharePointOnlinePowerShell .

Stan zwrócony w poleceniu cmdlet Get-FileStatus zawiera również informacje o tym, czy plik jest chroniony przez usługę Rights Management, a jeśli tak, jaki szablon usługi Rights Management został użyty do zastosowania tej ochrony. Jeśli plik był chroniony za pomocą uprawnień niestandardowych (zasada praw ad hoc), a nie szablonu, zamiast nazwy szablonu wyświetlany jest komunikat "Ograniczony dostęp". Ponadto wyświetlany jest właściciel usługi Rights Management i wystawca usługi Rights Management oraz informacje o tym, kiedy plik był chroniony.

To polecenie cmdlet zwraca informacje o etykiecie tylko z własnej dzierżawy.

Należy pamiętać, że pliki chronione hasłem zawsze zwracają stan ochrony False.

To polecenie cmdlet można uruchomić nieinterakcyjne.

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

To polecenie zawiera informacje o pliku oznaczonym jako "Poufne \ Grupa finansów", który jest etykietą skonfigurowaną dla dzierżawy. Ten plik został ręcznie oznaczony etykietą przez Johna i jest również chroniony przy użyciu szablonu usługi Rights Management "Contoso — poufne finanse".

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

To polecenie pobiera informacje o etykietach i ochronie wszystkich plików na serwerze Finance, w folderze Projekty i dowolnym z jego podfolderów. Wyniki są eksportowane do pliku o nazwie Report.csv , dzięki czemu można je łatwiej przeszukiwać i sortować. Jeśli poprzedni raport istnieje w C:\Reports\Report.csv, zostanie on nadpisany.

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

To polecenie pobiera informacje o etykiecie i ochronie tylko dla plików oznaczonych etykietą "Poufne" (niezależnie od ich podetykiety) na serwerze Finance, w folderze Projekty i dowolnym z jego podfolderów. Wyniki są eksportowane do pliku o nazwie Report.csv , dzięki czemu można je łatwiej przeszukiwać i sortować. Jeśli poprzedni raport istnieje w C:\Reports\Report.csv, zostanie on nadpisany.

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

5

To polecenie podaje liczbę plików z etykietą "Poufne", które znajdują się w folderze C:\Projects i dowolnym z jego podfolderów. W tym przykładzie znaleziono 5 plików.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.