Set-AIPFileClassification

  • Reference
Modul:
AzureInformationProtection

Prohledá soubor a automaticky pro něj nastaví popisek služby Azure Information Protection, a to v závislosti na podmínkách, které jsou nastavené v zásadách.

Syntax

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Description

Rutina Set-AIPFileClassification může při konfiguraci popisků pro automatickou klasifikaci automaticky použít popisek pro jeden nebo více souborů.

Když se tato rutina spustí, zkontroluje obsah souboru a pokud jsou pro popisek splněné nakonfigurované podmínky, použije se tento popisek. Tato akce automaticky použije ochranu, pokud vybraný popisek použije ochranu.

Ve výchozím nastavení platí: pokud soubor už má popisek, tento popisek nebo ochrana se nenahrazuje.

Pokud soubor není označený ručně, nebyly splněny podmínky, které jste zadali, nebo soubor má vyšší klasifikaci, soubor se přeskočí jediným komentářem "Žádný popisek, který se má použít".

Další informace najdete v tématu: Použití popisku citlivosti pro obsah automaticky

Spuštění rutiny neinteraktivně

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

Příklady

Příklad 1: Prohledání všech souborů ve složce a jejích podsložkách a použití popisků na základě nakonfigurovaných podmínek pro automatickou klasifikaci

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Tento příkaz zkontroluje všechny soubory ve složce Projekty a libovolné její podsložky a nastaví popisky podle nakonfigurovaných podmínek v zásadách automatického popisování. V tomto příkladu je pět souborů a dva soubory jsou automaticky označené. Soubor Datasheet.pdf není označený, protože jeho obsah neodpovídá nakonfigurovaným podmínkám pro automatickou klasifikaci Analysis.xlsx byl již ručně označený a Pricelist.xlsx má vyšší popisek. Vzhledem k tomu, že příkaz běží bez parametru -Force , stávající popisky proAnalysis.xlsx a Pricelist.xlsx se nepřepíšou.

Pokud jsou použité popisky také nakonfigurované pro použití ochrany Rights Management, soubory úspěšně označené pomocí tohoto příkazu jsou také chráněné. V tomto případě je vlastníkem Rights Management (který pro Rights Management má oprávnění Úplné řízení) těchto souborů uživatel, který spustil příkaz prostředí PowerShell.

Vzhledem k tomu, že je zadán parametr PreserveFileDetails, zůstane datum změny označených souborů beze změny.

Příklad 2: Prohledání všech souborů ve složce a jejích podsložkách a použití popisků na základě nakonfigurovaných podmínek pro automatickou klasifikaci s přepsáním veškerých stávajících popisků

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Tento příkaz je podobný předchozímu příkladu, že také prohledá všechny soubory ve složce Projekty a všechny její podsložky a nastaví popisky podle nakonfigurovaných podmínek pro automatické popisování. Tentokrát ale příkaz obsahuje parametr -Force , nahradí také existující popisek pro Dashboard.xlsxa Pricelist.xlsx.

Obsah Datasheet.pdf neodpovídá žádným nakonfigurovaným podmínkám a tento soubor zůstává bez popisku.

Příklad 3: (pouze klient sjednoceného popisování) Zkontrolujte soubor v režimu WhatIf pro všechny známé typy citlivých informací.

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

Tento příkaz zjistí všechny známé typy informací v souboru Project1.docx bez použití ochrany nebo popisku.

Příklad 4: (pouze klient sjednoceného popisování) Zkontrolujte soubor v režimu WhatIf pro konkrétní typy citlivých informací.

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

Tento příkaz zjistí konkrétní typy informací "Číslo platební karty" a "Číslo sociálního pojištění (SSN)" v souboruProject1.docx bez použití ochrany nebo popisku.

Příklad 5: (pouze klient sjednoceného popisování) Zkontrolujte soubor v režimu WhatIf pro konkrétní typy citlivých informací a zobrazte nalezené hodnoty.

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

Podobně jako v předchozím příkladu první příkaz zjistí konkrétní typy informací "Číslo platební karty" a "Číslo sociálního pojištění (SSN)" v souboruProject1.docx bez použití ochrany nebo popisku. V tomto příkladu se ale výsledky ukládají do proměnné pro další zpracování.

Druhý příkaz se pak použije k zobrazení obsahu odpovídajících typů informací, které zahrnují parametr SensitiveContents.

Poslední příkaz zobrazí a formátuje pro snadnější čtení dat, která jsou identifikována prvním typem citlivých informací, což je v tomto příkladu podrobnosti o platební kartě.

Parametry

-DiscoveryInfoTypes

Poznámka: Tento parametr se podporuje pouze u klienta sjednoceného popisování azure Information Protection.

Zadejte typy citlivých informací, které se mají zjistit při použití parametru WhatIf .

Pokud chcete vyhledat konkrétní typy citlivých informací, zadejte číslo ID entity pro tento typ informací, které můžete najít v typech citlivých informací v Exchange Server.

Například "50842eb7-edc8-4019-85dd-5a5c1f2bb085" je číslo, které se má zadat pro typ citlivých informací číslo platební karty.

Type:String[]
Accepted values:All, "rule_id_1", "rule_id_2"
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Při splnění nakonfigurovaných podmínek nahradí existující popisek.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JustificationMessage

Zdůvodnění pro použití nižší úrovně klasifikačního popisku, odebrání popisku nebo odebrání ochrany, pokud zásady Azure Information Protection vyžadují, aby uživatel zadal tyto informace.

Pokud nastavení popisku aktivuje odůvodnění a tento důvod není zadán, popisek se nepoužije, i když je nastaven parametr -Force . V tomto případě je vrácen stav "Vynechán" s následujícím komentářem: "Žádný popisek, který se má použít"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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é cardy nejsou podporovány a umístění WebDav nejsou podporována.

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

-PreserveFileDetails

Zadejte tento parametr, který ponechá datum beze změny u dokumentů, které označíte.

U místních nebo síťových souborů zůstane datum poslední změny nezměněné.

U souborů SharePointu zůstane datum změny a datum změny podle data nezměněné.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Relevantní pro: Pouze klient sjednoceného popisování

Ukazuje, co se stane, když se rutina spustí a je ekvivalentem režimu zjišťování skeneru. Změny se nebudou vztahovat na vstupní nebo výstupní soubory.

Pomocí tohoto parametru discoveryInfoTypes vyhledejte všechny typy citlivých informací nebo konkrétní typy citlivých informací.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

System.String[]

Výstupy

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult