Sdílet prostřednictvím

Get-FileStatus

  • Reference
Modul:
PurviewInformationProtection

Získá Microsoft Purview Information Protection popisek a informace o ochraně pro zadaný soubor nebo soubory.

Syntaxe

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

Description

Rutina Get-FileStatus vrátí stav zadaného souboru nebo všech souborů v zadané cestě. Tento stav zahrnuje, jestli má soubor popisek, a pokud ano, název popisku, kdo ho použil, jak byl použit a kdy.

Pokud máte soubory uložené v SharePointu Online, použijte místo toho rutinu Get-FileSensitivityLabelInfo z modulu SharePointOnlinePowerShell .

Stav vrácený rutinou Get-FileStatus také zahrnuje, jestli je soubor chráněný službou Rights Management, a pokud ano, jaká šablona Služby Rights Management byla použita k použití této ochrany. Pokud byl soubor chráněný pomocí vlastních oprávnění (ad hoc zásad práv) místo šablony, zobrazí se místo názvu šablony text Omezený přístup. Kromě toho se zobrazí vlastník služby Rights Management a vystavitel služby Rights Management a informace o tom, kdy byl soubor chráněn.

Tato rutina vrací informace o popisku jenom z vašeho vlastního tenanta.

Soubory chráněné heslem vždy vrací stav ochrany False.

Tuto rutinu můžete spustit neinteraktivně.

Příklady

Příklad 1: Získání popisku a stavu ochrany jednoho souboru

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

Tento příkaz poskytuje informace o souboru označeném jako Důvěrné \ Finanční skupina, což je popisek nakonfigurovaný pro vašeho tenanta. Jan tento soubor označil ručně a je také chráněný pomocí šablony Rights Management Contoso – důvěrné finance.

Příklad 2: Získání popisku a stavu ochrany pro všechny soubory ve složce a export výsledků do souboru CSV

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

Tento příkaz získá popisky a informace o ochraně všech souborů na finančním serveru ve složce Projekty a všech jejích podsložkách. Výsledky se exportují do souboru s názvemReport.csv , aby bylo možné je snadněji prohledávat a řadit. Pokud vC:\Reports\Report.csvexistuje předchozí sestava , přepíše se.

Příklad 3: Vypište soubory označené jako Důvěrné a exportujte výsledky do souboru CSV.

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

Tento příkaz získá popisek a informace o ochraně jenom pro soubory, které jsou na finančním serveru ve složce Projekty a ve všech jejích podsložkách označené jako Důvěrné (bez ohledu na jejich dílčí popisek). Výsledky se exportují do souboru s názvemReport.csv , aby bylo možné je snadněji prohledávat a řadit. Pokud vC:\Reports\Report.csvexistuje předchozí sestava , přepíše se.

Příklad 4: Počet souborů s popiskem Důvěrné

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

5

Tento příkaz zobrazí počet souborů s popiskem Důvěrné, které jsou ve složce C:\Projects a ve všech jejích podsložkách. V tomto příkladu je nalezeno 5 souborů.

Parametry

-Path

Určuje místní cestu, síťovou cestu nebo adresu URL serveru SharePoint Server k souborům, pro které chcete získat popisek a informace o ochraně. Zástupné znaky se nepodporují.

U sharepointových cest jsou podporovány následující:

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

Příklad:

Cesty můžou obsahovat mezery, když uzavřete hodnotu cesty do uvozovek.

Typ:String[]
Aliasy:FullName, FileName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

System.String[]

Výstupy

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult