Get-AIPFileStatus

  • Referencia
Modul:
AzureInformationProtection

Lekéri egy adott fájl vagy fájl Azure Information Protection címkéjét és védelmi adatait.

Syntax

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

Description

A Get-AIPFileStatus parancsmag egy megadott fájl vagy egy megadott elérési út összes fájljának Azure-Information Protection állapotát adja vissza. Ez az állapot magában foglalja, hogy a fájl rendelkezik-e címkével, és ha igen, akkor a címke neve, ki alkalmazta, hogyan alkalmazták, és mikor.

Ha a fájlok a SharePoint Online-ban vannak tárolva, használja helyette a SharePointOnlinePowerShell modul Get-FileSensitivityLabelInfo parancsmagját.

A Get-AIPFileStatus parancsmagban visszaadott állapot azt is tartalmazza, hogy a fájlt a Rights Management védi-e, és ha igen, milyen Rights Management-sablont használtak a védelem alkalmazásához. Ha a fájlt sablon helyett egyéni engedélyekkel (alkalmi jogosultsági szabályzattal) védték, a sablon neve helyett a "Korlátozott hozzáférés" felirat jelenik meg. Emellett megjelenik a Rights Management-tulajdonos és a Rights Management-kibocsátó , valamint a fájl védelme.

Ez a parancsmag csak a saját bérlőjéből ad vissza címkeadatokat.

Vegye figyelembe, hogy a jelszóval védett fájlok mindig a False (Hamis) védelmi állapotot adják vissza.

Ezt a parancsmagot nem interaktív módon futtathatja. További információt az egyesített címkézési ügyfél-rendszergazdai útmutatóban talál.

Példák

1. példa: Egyetlen fájl címkéjének és védelmi állapotának lekérése

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

Ez a parancs információt nyújt a "Bizalmas \ Pénzügyi csoport" címkével ellátott fájlról, amely a bérlőhöz konfigurált címke. Ezt a fájlt John manuálisan címkézte, és a "Contoso – Confidential Finance" Rights Management-sablonnal is védett.

2. példa: A mappa összes fájljának címkéjének és védelmi állapotának lekérése, majd az eredmények exportálása CSV-fájlba

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

Ez a parancs lekéri a pénzügyi kiszolgálón, a Projektek mappában és annak almappáiban található összes fájl címkéjét és védelmi információját. A rendszer exportálja az eredményeket a AIP-status.csv nevű fájlba, hogy könnyebben lehessen keresni és rendezni őket. Ha egy korábbi jelentés létezik C:\Reports\Report.csv, a program felülírja azt.

3. példa: Listázhatja a "Bizalmas" címkével ellátott fájlokat, és exportálhatja az eredményeket egy CSV-fájlba

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

Ez a parancs csak a "Bizalmas" címkével ellátott fájlok címkéjét és védelmi információit kapja meg (az alcímkéktől függetlenül) a Pénzügyi kiszolgálón, a Projektek mappában és annak almappáiban. A rendszer exportálja az eredményeket a AIP-status.csv nevű fájlba, hogy könnyebben lehessen keresni és rendezni őket. Ha egy korábbi jelentés létezik C:\Reports\Report.csv, a program felülírja azt.

4. példa: "Bizalmas" címkével rendelkező fájlok száma

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

5

Ez a parancs a C:\Projects mappában és annak almappáiban található "Bizalmas" címkével ellátott fájlok számát adja meg. Ebben a példában 5 fájl található.

Paraméterek

-Path

Megadja azoknak a fájloknak a helyi elérési útját, hálózati elérési útját vagy SharePoint Server URL-címét, amelyekhez a címkét és a védelmi információkat le szeretné kapni. Helyettesítő karakterek nem használhatók.

SharePoint-elérési utak esetén az alábbiak támogatottak:

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

Például:

Az elérési utak szóközöket is tartalmazhatnak, ha az elérési út értékét idézőjelek közé foglalja.

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

Bevitelek

System.String[]

Kimenetek

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult