Get-AIPFileStatus

  • Referentie
Module:
AzureInformationProtection

Hiermee haalt u de Azure Information Protection label- en beveiligingsgegevens op voor een opgegeven bestand of bestanden.

Syntax

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

Description

De cmdlet Get-AIPFileStatus retourneert de Azure-Information Protection 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-AIPFileStatus , bevat ook of het bestand wordt 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 wordt de Rights Management-eigenaar en Rights Management-uitgever weergegeven en wanneer het bestand is beveiligd.

Deze cmdlet retourneert alleen labelgegevens van uw eigen tenant.

Houd er rekening mee dat met een wachtwoord beveiligde bestanden altijd de beveiligingsstatus False retourneren.

U kunt deze cmdlet niet interactief uitvoeren. Zie de beheerdershandleiding voor de unified labeling-client voor meer informatie.

Voorbeelden

Voorbeeld 1: De label- en beveiligingsstatus van één bestand ophalen

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

Met deze opdracht vindt u informatie over een bestand met het label Vertrouwelijk \ Financiën, een label dat is geconfigureerd voor uw tenant. Dit bestand is handmatig gelabeld door John en wordt ook beveiligd met behulp van de Rights Management-sjabloon Contoso - Confidential Finance.

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

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

Met deze opdracht worden de label- en beveiligingsgegevens opgehaald van alle bestanden 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 AIP-status.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 weergeven en de resultaten exporteren naar een CSV-bestand

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

Met deze opdracht worden de label- en beveiligingsgegevens opgehaald voor alleen de bestanden met het label Vertrouwelijk (ongeacht hun 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 AIP-status.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 een label Vertrouwelijk

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

5

Deze opdracht biedt het aantal bestanden met het label Vertrouwelijk die zich in de map C:\Projects en een van de submappen ervan bevinden. In dit voorbeeld worden 5 bestanden gevonden.

Parameters

-Path

Hiermee geeft u een lokaal pad, netwerkpad of SharePoint Server-URL op naar de bestanden waarvoor u het label en de beveiligingsinformatie 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[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

System.String[]

Uitvoerwaarden

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult