Get-AIPFileStatus
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:
- C:\Folder\
- C:\Folder\Filename
- \\Server\Mapp
- http://sharepoint.contoso.com/Shared%20Documents/Folder
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