Set-AIPFileClassification

  • Referencia
Modul:
AzureInformationProtection

Megvizsgál egy fájlt, hogy a házirendben konfigurált feltételeknek megfelelően automatikusan beállítsa az Azure Information Protection-címkét a fájlhoz.

Syntax

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

Description

A Set-AIPFileClassification parancsmag automatikusan alkalmazhat címkét egy vagy több fájlra, amikor címkéket konfigurál az automatikus besoroláshoz.

A parancsmag futtatásakor ellenőrzi a fájl tartalmát, és ha egy címke konfigurált feltételei teljesülnek, a rendszer alkalmazza a címkét. Ez a művelet automatikusan védelmet alkalmaz, ha a kijelölt címke védelmet alkalmaz.

Ha a fájl már rendelkezik címkével, a parancsmag alapértelmezés szerint nem írja felül a már létező címkét vagy védelmet.

Ha egy fájl nincs címkézve, mert manuálisan lett címkézve, nem egyezett meg a megadott feltételekkel, vagy a fájl magasabb besorolású volt, a rendszer kihagyja a fájlt a "Nincs alkalmazandó címke" megjegyzéssel.

További információ: Bizalmassági címke automatikus alkalmazása a tartalomra

A parancsmag nem interaktív futtatása

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: Egy adott mappában és annak almappáiban található összes fájl vizsgálata, valamint címkék alkalmazása az automatikus besoroláshoz konfigurált feltételek alapján

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    :

Ez a parancs megvizsgálja a Projektek mappában és annak almappáiban található összes fájlt, és az automatikus címkézési házirend konfigurált feltételeinek megfelelően állítja be a címkéket. Ebben a példában öt fájl található, és a rendszer két fájlra alkalmazott automatikusan címkét. A Datasheet.pdf fájl nincs címkézve, mert tartalma nem egyezik meg az automatikus besorolás konfigurált feltételeivel ,Analysis.xlsx már manuálisan címkézték, és Pricelist.xlsx magasabb címkével rendelkezik. Mivel a parancs a -Force paraméter nélkül fut, a Analysis.xlsx és aPricelist.xlsx meglévő címkéi nem lesznek felülírva.

Ha az alkalmazott címkék úgy vannak konfigurálva, hogy Rights Management-védelmet is alkalmazzanak, akkor a paranccsal sikeresen megcímkézett fájlok védelemmel is el lettek látva. Ebben az esetben a fájlok Rights Management-tulajdonosa (aki teljes körű vezérléssel rendelkezik a Rights Managementhez) volt az a felhasználó, aki a PowerShell-parancsot futtatta.

Mivel a PreserveFileDetails paraméter meg van adva, a címkézett fájlok módosítási dátuma változatlan marad.

2. példa: Egy adott mappában és annak almappáiban található összes fájl vizsgálata, valamint címkék alkalmazása az automatikus besoroláshoz konfigurált feltételek alapján, a már létező címkék felülírásával

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    :

Ez a parancs hasonló az előző példához, amelyben a Projektek mappában és annak almappáiban található összes fájlt is megvizsgálja, és az automatikus címkézés konfigurált feltételeinek megfelelően állítja be a címkéket. Ezúttal azonban, mivel a parancs tartalmazza a -Force paramétert, az Dashboard.xlsxés Pricelist.xlsxmeglévő címkéjét is lecseréli.

A Datasheet.pdf tartalma nem felelt meg a konfigurált feltételeknek, és ez a fájl címke nélkül marad.

3. példa: (csak egyesített címkézési ügyfél) Keressen egy fájlt WhatIf módban az összes ismert bizalmas adattípushoz

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                 :

Ez a parancs Project1.docx fájl összes ismert adattípusát felderíti védelem vagy címke alkalmazása nélkül.

4. példa: (csak egyesített címkézési ügyfél) Adott bizalmas információtípusok keresése WhatIf módban

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                 :

Ez a parancs felderíti a "Hitelkártyaszám" és a "TAJ-szám (SSN)" konkrét információtípusait Project1.docx fájlban védelem vagy címke alkalmazása nélkül.

5. példa: (csak egyesített címkézési ügyfél) Vizsgálja meg a fájlt WhatIf módban adott bizalmas információtípusok keresése és a talált értékek megjelenítése céljából

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

Az előző példához hasonlóan az első parancs a "Hitelkártyaszám" és a "TAJ-szám (SSN)" konkrét információtípusait deríti fel Project1.docx fájlban védelem vagy címke alkalmazása nélkül. Ebben a példában azonban az eredmények egy változóban vannak tárolva további feldolgozás céljából.

A második parancs ezután a megfeleltetett információtípusok tartalmának megjelenítésére szolgál, amely tartalmazza a SensitiveContents paramétert.

Az utolsó parancs megjeleníti és formázja az első bizalmas adattípus által azonosított adatokat, amelyek ebben a példában a hitelkártya adatai.

Paraméterek

-DiscoveryInfoTypes

Megjegyzés: Ez a paraméter csak az Azure Information Protection egységes címkézési ügyféllel támogatott.

Adja meg a WhatIf paraméter használatakor felderítendő bizalmas információtípusokat.

Ha konkrét bizalmas adattípusokat szeretne keresni, adja meg az adott adattípus entitásazonosító-számát, amelyet a bizalmas adattípusok között talál a Exchange Server.

Az "50842eb7-edc8-4019-85dd-5a5c1f2bb085" például a hitelkártyaszám bizalmas adattípusához megadható szám.

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

Lecseréli a már meglévő címkét, ha a konfigurált feltételek érvényesek.

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

-JustificationMessage

A besorolási címke szintje csökkentésének, illetve egy címke vagy a védelem eltávolításának indoklása az lehet, ha az Azure Information Protection-házirend megköveteli, hogy a felhasználók megadják ezt az információt.

Ha egy címke beállítása kiváltja az indoklást, és ez az ok nincs megadva, a címke nem lesz alkalmazva, még akkor sem, ha a -Force paraméter be van állítva. Ebben az esetben a visszaadott állapot "Kihagyva" a következő megjegyzéssel: "Nincs alkalmazandó címke"

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

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

A helyettesítő karakterek nem támogatottak, és a WebDav-helyek nem támogatottak.

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

-PreserveFileDetails

Ezt a paramétert úgy adhatja meg, hogy a címkézett dokumentumok dátumát változatlanul hagyja.

Helyi vagy hálózati fájlok esetében az utolsó módosítás dátuma változatlan marad.

SharePoint-fájlok esetén a Módosítás dátuma és a Módosítás dátuma változatlan marad.

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

-WhatIf

A következőhöz kapcsolódó: Csak egységes címkézési ügyfél

Megmutatja, mi történne, ha a parancsmag futna, és egyenértékű a szkenner felderítési módjával. A módosítások nem lesznek érvényesek a bemeneti és kimeneti fájlokra.

Ezt a paramétert a DiscoveryInfoTypes paraméterrel használva megkeresheti az összes bizalmas adattípust vagy adott bizalmas információtípust.

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

Bevitelek

System.String[]

Kimenetek

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult