Delen via

Get-FileStatus

  • Referentie
Module:
PurviewInformationProtection

Hiermee haalt u de Microsoft Purview Informatiebeveiliging label- en beveiligingsgegevens op voor een of meer opgegeven bestanden.

Syntaxis

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

Description

De cmdlet Get-FileStatus retourneert de status van een opgegeven bestand of alle bestanden in een opgegeven pad. Deze status omvat of het bestand een label heeft en, als dat het geval is, de labelnaam, wie het heeft toegepast, hoe het is toegepast en wanneer.

Als uw bestanden zijn opgeslagen in SharePoint Online, gebruikt u in plaats daarvan de cmdlet Get-FileSensitivityLabelInfo uit de SharePointOnlinePowerShell-module .

De status die wordt geretourneerd in de cmdlet Get-FileStatus bevat ook of het bestand is beveiligd door Rights Management en, als dit het is, welke Rights Management-sjabloon is gebruikt om deze beveiliging toe te passen. Als het bestand is beveiligd met aangepaste machtigingen (een ad-hoc rechtenbeleid) in plaats van een sjabloon, wordt 'Beperkte toegang' weergegeven in plaats van de sjabloonnaam. Daarnaast worden de Rights Management-eigenaar en Rights Management-verlener weergegeven, en wanneer het bestand is beveiligd.

Deze cmdlet retourneert alleen labelgegevens van uw eigen tenant.

Houd er rekening mee dat bestanden met wachtwoordbeveiliging altijd de beveiligingsstatus Onwaar retourneren.

U kunt deze cmdlet niet-interactief uitvoeren.

Voorbeelden

Voorbeeld 1: Het label en de beveiligingsstatus van één bestand ophalen

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

Deze opdracht biedt informatie over een bestand dat is gelabeld als 'Groep Vertrouwelijk \ Financiën', een label dat is geconfigureerd voor uw tenant. Dit bestand is handmatig gelabeld door John en is ook beveiligd met behulp van de Rights Management-sjabloon Contoso - Confidential Finance.

Voorbeeld 2: Het label en de beveiligingsstatus ophalen voor alle bestanden in een map en de resultaten exporteren naar een CSV-bestand

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

Met deze opdracht worden de label- en beveiligingsgegevens opgehaald van alle bestanden op de financiële server, in de map Projecten en een van de submappen. De resultaten worden geëxporteerd naar het bestand met de naam Report.csv , zodat ze gemakkelijker kunnen worden doorzocht en gesorteerd. Als er een eerder rapport in C:\Reports\Report.csvbestaat, wordt het overschreven.

Voorbeeld 3: De bestanden met het label Vertrouwelijk vermelden en de resultaten exporteren naar een CSV-bestand

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

Met deze opdracht worden de label- en beveiligingsinformatie opgehaald voor alleen de bestanden met het label Vertrouwelijk (ongeacht het sublabel) op de server Financiën, in de map Projecten en een van de submappen. De resultaten worden geëxporteerd naar het bestand met de naam Report.csv , zodat ze gemakkelijker kunnen worden doorzocht en gesorteerd. Als er een eerder rapport in C:\Reports\Report.csvbestaat, wordt het overschreven.

Voorbeeld 4: aantal bestanden met het label Vertrouwelijk

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

5

Met deze opdracht wordt het aantal bestanden met het label 'Vertrouwelijk' opgegeven dat zich in de map C:\Projects en een van de submappen ervan bevindt. In dit voorbeeld worden 5 bestanden gevonden.

Parameters

-Path

Hiermee geeft u een lokaal pad, netwerkpad of SharePoint Server-URL op naar de bestanden waarvan u het label en de beveiligingsgegevens wilt ophalen. Jokertekens worden niet ondersteund.

Voor SharePoint-paden worden het volgende ondersteund:

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

Bijvoorbeeld:

Paden kunnen spaties bevatten wanneer u de padwaarde tussen aanhalingstekens plaatst.

Type:String[]
Aliassen:FullName, FileName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

System.String[]

Uitvoerwaarden

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult