Freigeben über


Get-FileStatus

Ruft die Microsoft Purview Information Protection Bezeichnungs- und Schutzinformationen für eine angegebene Datei(n) ab.

Syntax

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

Beschreibung

Das Cmdlet Get-FileStatus gibt die status einer angegebenen Datei oder aller Dateien in einem angegebenen Pfad zurück. Dieser status umfasst, ob die Datei eine Bezeichnung hat, und wenn dies der Fall ist, den Bezeichnungsnamen, wer sie angewendet hat, wie sie angewendet wurde und wann.

Wenn Ihre Dateien in SharePoint Online gespeichert sind, verwenden Sie stattdessen das Cmdlet Get-FileSensitivityLabelInfo aus dem SharePointOnlinePowerShell-Modul .

Die im Cmdlet Get-FileStatus zurückgegebene status enthält auch, ob die Datei durch Rights Management geschützt ist, und wenn ja, welche Rights Management-Vorlage zum Anwenden dieses Schutzes verwendet wurde. Wenn die Datei mit benutzerdefinierten Berechtigungen (einer Ad-hoc-Rechterichtlinie) anstelle einer Vorlage geschützt wurde, wird "Eingeschränkter Zugriff" anstelle des Vorlagennamens angezeigt. Darüber hinaus werden der Rights Management-Besitzer und der Rights Management-Aussteller und der Zeitpunkt angezeigt, an dem die Datei geschützt wurde.

Dieses Cmdlet gibt nur Bezeichnungsinformationen von Ihrem eigenen Mandanten zurück.

Beachten Sie, dass kennwortgeschützte Dateien immer den Schutz status False zurückgeben.

Sie können dieses Cmdlet nicht interaktiv ausführen.

Beispiele

Beispiel 1: Abrufen der Bezeichnung und des Schutz status einer einzelnen Datei

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

Dieser Befehl stellt Informationen zu einer Datei bereit, die als "Vertraulich \ Finanzgruppe" bezeichnet wird. Dabei handelt es sich um eine Bezeichnung, die für Ihren Mandanten konfiguriert ist. Diese Datei wurde von John manuell beschriftet und ist auch mithilfe der Rights Management-Vorlage "Contoso – Confidential Finance" geschützt.

Beispiel 2: Abrufen der bezeichnungs- und schutz status für alle Dateien in einem Ordner und Exportieren der Ergebnisse in eine CSV-Datei

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

Dieser Befehl ruft die Bezeichnungs- und Schutzinformationen aller Dateien auf dem Finanzserver im Ordner Projekte und in jedem seiner Unterordner ab. Die Ergebnisse werden in die Datei mit dem Namen Report.csv exportiert, damit sie einfacher durchsucht und sortiert werden können. Wenn ein vorheriger Bericht in C:\Reports\Report.csvvorhanden ist, wird er überschrieben.

Beispiel 3: Auflisten der Dateien mit der Bezeichnung "Vertraulich" und Exportieren der Ergebnisse in eine CSV-Datei

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

Dieser Befehl ruft die Bezeichnungs- und Schutzinformationen nur für die Dateien ab, die (unabhängig von ihrer Unterbezeichnung) auf dem Finanzserver im Ordner Projekte und in jedem seiner Unterordner mit der Bezeichnung "Vertraulich" versehen sind. Die Ergebnisse werden in die Datei mit dem Namen Report.csv exportiert, damit sie einfacher durchsucht und sortiert werden können. Wenn ein vorheriger Bericht in C:\Reports\Report.csvvorhanden ist, wird er überschrieben.

Beispiel 4: Anzahl der Dateien mit der Bezeichnung "Vertraulich"

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

5

Dieser Befehl stellt die Anzahl der Dateien mit der Bezeichnung "Vertraulich" bereit, die sich im Ordner "C:\Projects " und einem seiner Unterordner befinden. In diesem Beispiel werden 5 Dateien gefunden.

Parameter

-Path

Gibt einen lokalen Pfad, Netzwerkpfad oder SharePoint Server-URL zu den Dateien an, für die Sie die Bezeichnungs- und Schutzinformationen abrufen möchten. Platzhalter werden nicht unterstützt.

Für SharePoint-Pfade werden folgende Elemente unterstützt:

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

Beispiel:

Pfade können Leerzeichen enthalten, wenn Sie den Pfadwert in Anführungszeichen einschließen.

Typ:String[]
Aliase:FullName, FileName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

System.String[]

Ausgaben

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult