Get-AIPFileStatus

  • Reference
Modul:
AzureInformationProtection

Získá popisek a ochranu Azure Information Protection pro zadaný soubor nebo soubory.

Syntax

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

Description

Rutina Get-AIPFileStatus vrátí stav azure Information Protection 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 jsou vaše soubory uložené v SharePointu Online, použijte místo toho rutinu Get-FileSensitivityLabelInfo z modulu SharePointOnlinePowerShell .

Stav vrácený v rutině Get-AIPFileStatus také zahrnuje, jestli je soubor chráněný službou Rights Management a jestli ano, jakou šablonu Rights Management jste použili k použití této ochrany. Pokud byl soubor chráněný vlastními oprávněními (ad hoc zásadou práv) místo šablony, místo názvu šablony se zobrazí "Omezený přístup". Kromě toho se zobrazí vlastník rights Management a vystavitel Rights Management a když byl soubor chráněný.

Tato rutina vrátí pouze informace o popisku z vašeho vlastního tenanta.

Mějte na paměti, že soubory chráněné heslem vždy vrací stav ochrany false.

Tuto rutinu můžete spustit neinteraktivně. Další informace najdete v průvodci správcem klienta sjednoceného popisování.

Příklady

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

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

Tento příkaz poskytuje informace o souboru, který je označený jako "Důvěrné \ Finance group", což je popisek, který je nakonfigurovaný pro vašeho tenanta. Tento soubor byl označen ručně Johnem a je chráněný také 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-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

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

Příklad 3: Výpis souborů označených jako Důvěrné a export výsledků do souboru CSV

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

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

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

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

5

Tento příkaz poskytuje počet souborů s popiskem Důvěrné, které jsou ve složce C:\Projects a některé z jejích podsložek. V tomto příkladu se najde 5 souborů.

Parametry

-Path

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

U sharepointových cest se podporují následující možnosti:

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

Příklad:

Cesty můžou obsahovat mezery, když uzavřete hodnotu cesty s uvozovkami.

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

Vstupy

System.String[]

Výstupy

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult