Udostępnij za pośrednictwem

Get-FileStatus

  • Odwołanie
Moduł:
PurviewInformationProtection

Pobiera informacje o etykiecie Microsoft Purview Information Protection i ochronie dla określonego pliku lub plików.

Składnia

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

Opis

Polecenie cmdlet Get-FileStatus zwraca stan określonego pliku lub wszystkich plików w określonej ścieżce. Ten stan obejmuje, czy plik ma etykietę, a jeśli tak, nazwę etykiety, kto ją zastosował, sposób jego zastosowania 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 obejmuje również to, 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 przy użyciu uprawnień niestandardowych (zasad praw ad hoc) zamiast szablonu, zamiast nazwy szablonu jest wyświetlany komunikat "Ograniczony dostęp". Ponadto jest wyświetlany właściciel usługi Rights Management i wystawca usługi Rights Management oraz czas ochrony pliku.

To polecenie cmdlet zwraca tylko informacje o etykiecie 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.

Przykłady

Przykład 1. Pobieranie etykiety i stanu ochrony pojedynczego pliku

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, który jest oznaczony jako "Poufne \ Grupa finansów", który jest etykietą skonfigurowaną dla dzierżawy. Ten plik został oznaczony ręcznie przez Johna i jest on również chroniony przy użyciu szablonu usługi Rights Management "Contoso — poufne finanse".

Przykład 2. Pobieranie etykiety i stanu ochrony dla wszystkich plików w folderze i eksportowanie wyników do pliku CSV

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

To polecenie pobiera informacje o etykiecie i ochronie wszystkich plików na serwerze finance w folderze Projects i dowolnym z jego podfolderów. Wyniki są eksportowane do pliku o nazwie Report.csv , aby można je było łatwiej przeszukiwać i sortować. Jeśli poprzedni raport istnieje w C:\Reports\Report.csv, zostanie zastąpiony.

Przykład 3. Wyświetlanie listy plików z etykietą "Poufne" i eksportowanie wyników do pliku CSV

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 z etykietą "Poufne" (niezależnie od ich etykiety podrzędnej) na serwerze Finanse, w folderze Projekty i dowolnym z jego podfolderów. Wyniki są eksportowane do pliku o nazwie Report.csv , aby można je było łatwiej przeszukiwać i sortować. Jeśli poprzedni raport istnieje w C:\Reports\Report.csv, zostanie zastąpiony.

Przykład 4. Liczba plików z etykietą "Poufne"

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

5

To polecenie udostępnia 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.

Parametry

-Path

Określa ścieżkę lokalną, ścieżkę sieciową lub adres URL programu SharePoint Server do plików, dla których chcesz uzyskać etykietę i informacje o ochronie. Symbole wieloznaczne nie są obsługiwane.

W przypadku ścieżek programu SharePoint obsługiwane są następujące elementy:

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

Na przykład:

Ścieżki mogą zawierać spacje po ujęciu wartości ścieżki za pomocą cudzysłowów.

Typ:String[]
Aliasy:FullName, FileName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.String[]

Dane wyjściowe

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult