Dela via

Get-FileStatus

  • Referens
Modul:
PurviewInformationProtection

Hämtar Microsoft Purview Information Protection etikett och skyddsinformation för en angiven fil eller fil.

Syntax

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

Description

Cmdleten Get-FileStatus returnerar 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 i så fall 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-FileStatus omfattar ä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 etikettinformation endast från din egen klientorganisation.

Observera att lösenordsskyddade filer alltid returnerar skyddsstatusen False.

Du kan köra denna cmdlet icke-interaktivt.

Exempel

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

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

Det här kommandot innehåller information om en fil som är märkt som "Konfidentiell \ Ekonomigrupp", vilket ä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 skyddsstatus för alla filer i en mapp och exportera resultatet till en CSV-fil

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

Det här kommandot hämtar etikett- och skyddsinformation för alla filer på Finance-servern, i mappen Projects och någon av dess undermappar. Resultaten exporteras till filen med namnetReport.csv så att de enklare 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-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

Det här kommandot hämtar information om etikett och skydd för bara de filer som är märkta med "Konfidentiellt" (oavsett underetikett) på Finance-servern, i mappen Projects och någon av dess undermappar. Resultaten exporteras till filen med namnetReport.csv så att de enklare 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-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Det här kommandot tillhandahå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 information om etiketten och skyddet 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

Exempel:

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

Typ:String[]
Alias:FullName, FileName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

System.String[]

Utdata

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult