Megosztás a következőn keresztül:

Get-FileStatus

  • Referencia
Modul:
PurviewInformationProtection

Lekéri egy adott fájl vagy fájl Microsoft Purview információvédelem címkéjét és védelmi adatait.

Syntax

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

Description

A Get-FileStatus parancsmag egy megadott fájl vagy egy megadott elérési út összes fájljának á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-FileStatus 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" jelenik meg. Emellett megjelenik a Rights Management tulajdonosa és a Rights Management kiállítója , valamint a fájl védelme.

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

Vegye figyelembe, hogy a jelszóval védett fájlok mindig Hamis védelmi állapotot adnak vissza.

Ezt a parancsmagot nem interaktív módon futtathatja.

Példák

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

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

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édi.

2. példa: Kérje le a mappa összes fájljának címkéjét és védelmi állapotát, és exportálja az eredményeket egy CSV-fájlba

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

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

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-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.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étő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 Report.csv nevű fájlba, hogy könnyebben lehessen keresni és rendezni őket. Ha egy korábbi jelentés létezik C:\Reports\Report.csv, az felülíródik.

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

PS C:\> (Get-FileStatus -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 a következők támogatottak:

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

Például:

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

Típus:String[]
Aliasok:FullName, FileName
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

Bevitelek

System.String[]

Kimenetek

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult