Get-AIPFileStatus

  • Referenz
Modul:
AzureInformationProtection

Ruft die Azure Information Protection Bezeichnungs- und Schutzinformationen für eine angegebene Datei oder Dateien ab.

Syntax

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

Beschreibung

Das Cmdlet Get-AIPFileStatus gibt den Azure Information Protection Status einer angegebenen Datei oder aller Dateien in einem angegebenen Pfad zurück. Dieser Status enthält, ob die Datei über eine Bezeichnung verfügt, und wenn dies der Fall ist, der Bezeichnungsname, der 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 .

Der status, der im Cmdlet Get-AIPFileStatus zurückgegeben wird, enthält auch, ob die Datei durch Rights Management geschützt ist, und wenn dies der Fall ist, welche Rights Management-Vorlage verwendet wurde, um diesen Schutz anzuwenden. 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 wird der Rechteverwaltungsbesitzer und der Rechteverwaltungsherausgeber angezeigt, und wann die Datei geschützt wurde.

Dieses Cmdlet gibt Bezeichnungsinformationen nur von 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. Weitere Informationen finden Sie im Unified Labeling Client Administratorhandbuch.

Beispiele

Beispiel 1: Abrufen des Bezeichnungs- und Schutzstatus einer einzelnen Datei

PS C:\> Get-AIPFileStatus -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, die als "Vertraulich \ Finanzgruppe" bezeichnet wird. Dabei handelt es sich um eine Bezeichnung, die für Ihren Mandanten konfiguriert ist. Diese Datei wurde manuell von John gekennzeichnet und wird auch durch die Vorlage "Rechteverwaltung" "Contoso - Vertrauliche Finanzen" geschützt.

Beispiel 2: Abrufen des Bezeichnungs- und Schutzstatus für alle Dateien in einem Ordner und Exportieren der Ergebnisse in eine CSV-Datei

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

Dieser Befehl ruft die Bezeichnungs- und Schutzinformationen aller Dateien auf dem Finance-Server im Ordner "Projekte" und eines seiner Unterordner ab. Die Ergebnisse werden in die Datei mit dem Namen AIP-status.csv exportiert, sodass 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-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv

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

Beispiel 4: Anzahl von Dateien mit einer Bezeichnung "Vertraulich"

PS C:\> (Get-AIPFileStatus -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 eines seiner Unterordner befinden. In diesem Beispiel werden 5 Dateien gefunden.

Parameter

-Path

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

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

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

Beispiel:

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

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

System.String[]

Ausgaben

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult