Get-AIPFileStatus

  • Referens
Modul:
AzureInformationProtection

Hämtar Azure Information Protection etikett- och skyddsinformation för en angiven fil eller filer.

Syntax

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

Description

Cmdleten Get-AIPFileStatus returnerar Azure-Information Protection status för en angiven fil eller alla filer i en angiven sökväg. Den här statusen omfattar om filen har en etikett, och om den gör det, etikettnamnet, vem som tillämpade den, hur den tillämpades och när.

Om dina filer lagras i SharePoint Online använder du cmdleten Get-FileSensitivityLabelInfo från SharePointOnlinePowerShell-modulen i stället.

Statusen som returneras i cmdleten Get-AIPFileStatus innehåller även om filen skyddas av Rights Management och i så fall vilken Rights Management-mall som användes för att tillämpa det här skyddet. Om filen skyddades med anpassade behörigheter (en ad hoc-rättighetsprincip) i stället för en mall visas "Begränsad åtkomst" i stället för mallnamnet. Dessutom visas Rights Management-ägaren och Rights Management-utfärdaren och när filen skyddades.

Den här cmdleten returnerar endast etikettinformation från din egen klientorganisation.

Observera att lösenordsskyddade filer alltid returnerar skyddsstatusen false.

Du kan köra den här cmdleten icke-interaktivt. Mer information finns i administratörsguiden för enhetlig etikettering.

Exempel

Exempel 1: Hämta etiketten och skyddsstatusen för en enskild fil

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

Det här kommandot innehåller information om en fil som är märkt med "Konfidentiell \ Ekonomigrupp", som är en etikett som har konfigurerats för din klientorganisation. Den här filen har etiketterats manuellt av John och den skyddas också med hjälp av Rights Management-mallen "Contoso – Konfidentiell ekonomi".

Exempel 2: Hämta etiketten och skyddsstatusen för alla filer i en mapp och exportera resultatet till en CSV-fil

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

Det här kommandot hämtar etiketten och skyddsinformationen för alla filer på Finance-servern, i mappen Projects och någon av dess undermappar. Resultaten exporteras till filen med namnetAIP-status.csv så att de lättare kan sökas igenom och sorteras. Om det finns en tidigare rapport i C:\Reports\Report.csvskrivs den över.

Exempel 3: Lista filerna med etiketten "Konfidentiellt" och exportera resultatet till en CSV-fil

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

Det här kommandot hämtar etikett- och skyddsinformationen för bara de filer som är märkta med "Konfidentiellt" (oavsett underetikett) på Ekonomi-servern, i mappen Projects och någon av dess undermappar. Resultaten exporteras till filen med namnetAIP-status.csv så att de lättare kan sökas igenom och sorteras. Om det finns en tidigare rapport i C:\Reports\Report.csvskrivs den över.

Exempel 4: Antal filer med etiketten "Konfidentiellt"

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

5

Det här kommandot innehåller antalet filer med etiketten "Konfidentiellt" som finns i mappen C:\Projects och någon av dess undermappar. I det här exemplet hittas 5 filer.

Parametrar

-Path

Anger en lokal sökväg, nätverkssökväg eller SharePoint Server-URL till de filer som du vill hämta etikett- och skyddsinformation för. Jokertecken stöds inte.

För SharePoint-sökvägar stöds följande:

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

Ett exempel:

Sökvägar kan innehålla blanksteg när du omger sökvägsvärdet med citattecken.

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

Indata

System.String[]

Utdata

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult