Get-FileStatus

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

Das Cmdlet Get-FileStatus gibt den Status einer angegebenen Datei oder aller Dateien in einem angegebenen Pfad zurück. Zu diesem Status gehört, ob die Datei über eine Bezeichnung verfügt, und wenn ja, den Namen der Bezeichnung, wer sie angewendet hat, wie und wann sie angewendet wurde.

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

Der im Cmdlet Get-FileStatus zurückgegebene Status umfasst 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 anstelle des Vorlagennamens "Eingeschränkter Zugriff" angezeigt. Darüber hinaus werden der Rights Management-Besitzer und der Rights Management-Aussteller sowie der Zeitpunkt des Schutzes der Datei angezeigt.

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

Beachten Sie, dass kennwortgeschützte Dateien immer den Schutzstatus "False" zurückgeben.

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

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 enthält Informationen zu einer Datei mit der Bezeichnung "Vertraulich \ Finanzgruppe", bei der es sich um eine Bezeichnung handelt, die für Ihren Mandanten konfiguriert ist. Diese Datei wurde von John manuell bezeichnet und ist auch durch die Rights Management-Vorlage "Contoso – Confidential Finance" geschützt.

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

Mit diesem Befehl werden die Bezeichnung und die Schutzinformationen aller Dateien auf dem Finance-Server, im Ordner "Projekte" und in allen zugehörigen Unterordnern abgerufen. Die Ergebnisse werden in die DateiReport.csvexportiert , damit sie leichter durchsucht und sortiert werden können. Wenn ein vorheriger Bericht in C:\Reports\Report.csvvorhanden ist, wird er überschrieben.

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

Mit diesem Befehl werden die Bezeichnung und die Schutzinformationen nur für die Dateien abgerufen, die auf dem Finance-Server, im Ordner "Projekte" und in einem seiner Unterordner mit der Bezeichnung "Vertraulich" gekennzeichnet sind (unabhängig von ihrer Unterbezeichnung). Die Ergebnisse werden in die DateiReport.csvexportiert , damit sie leichter durchsucht und sortiert werden können. Wenn ein vorheriger Bericht in C:\Reports\Report.csvvorhanden ist, wird er überschrieben.

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

5

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

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.