Set-FileLabel

Modul:

PurviewInformationProtection

A fájl bizalmassági címkéjét és védelmét manuális címkézéssel vagy automatikus címkézéssel állítja be a címke konfigurációjának vagy egyéni engedélyeinek megfelelően.

Syntax

Set-FileLabel
   [-Path] <String[]>
   -LabelId <Guid>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]

Set-FileLabel
   [-Path] <String[]>
   -LabelId <Guid>
   [-JustificationMessage <String>]
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]

Set-FileLabel
   [-Path] <String[]>
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [<CommonParameters>]

Set-FileLabel
   [-Path] <String[]>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-Force]
   [-PreserveFileDetails]
   [-AutoLabel]
   [<CommonParameters>]

Set-FileLabel
   [-Path] <String[]>
   [-PreserveFileDetails]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [<CommonParameters>]

Description

Az Microsoft Purview információvédelem-ügyfél esetében a Set-FileLabel parancsmag egy vagy több fájl bizalmassági címkéjét állítja be. Ez a művelet automatikusan alkalmazhat védelmet, ha a címkék titkosításra vannak konfigurálva.

Emellett ezzel a parancsmaggal egyéni engedélyeket is alkalmazhat, amikor a New-CustomPermissions parancsmaggal alkalmi védelmi házirend-objektumként jönnek létre.

Ha a parancs sikeresen fut, bármely meglévő címke vagy védelem lecserélhető.

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ójában talál.

Megjegyzés

Ha a Set-FileLabel parancsmagot ciklusban futtatja, adja hozzá ezt a két sort a parancsmag után: [GC]::Collect()
[GC]::WaitForPendingFinalizers()

Példák

1. példa: Alkalmazza az "Általános" címkét minden olyan fájlra, amely jelenleg nem rendelkezik címkével

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-FileLabel -LabelId d9f23ae3-4321-4321-4321-f515f824c57b
FileName                              Status Comment
--------                              ------ ------------
\\Finance\Projects\Image.jpg          Success
\\Finance\Projects\Pricelist.pdf      Success
\\Finance\Projects\Announcement.docx  Success
\\Finance\Projects\Analysis.xlsx      Success

Ez a parancs először azonosítja az összes olyan fájlt, amelyet a Get-FileStatus parancsmag nem címkéz. Ezután ezeket a fájlokat az "Általános" címke azonosító szerinti megadásával címkézik.

2. példa: Alkalmazza az "Általános" címkét .docx nem címkézett fájlokra

PS C:\> Get-ChildItem C:\Projects\*.docx -File -Recurse | Get-FileStatus | where {$_.IsLabeled -eq $False} | Set-FileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b
FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

Ez a parancs először a Get-Child-Item paranccsal azonosítja a C:\Projects mappában (és annak almappáiban) lévő összes .docx fájlt, majd megkeresi azokat a fájlokat, amelyeket a Get-FileStatus parancsmaggal nem címkéznek. Az eredményként kapott fájlokat a rendszer az "Általános" címke azonosító alapján történő megadásával címkézi.

Megjegyzés

Ez a parancs a FullName Elérési út aliasát használja, hogy a Get-Child-Item a Get-FileStatus használatával használható legyen.

3. példa: Alkalmazza az "Általános" címkét egy mappa összes fájljára és annak almappáira

PS C:\> Set-FileLabel -Path C:\Projects\ -LabelId d9f23ae3-1324-1234-1234-f515f824c57b
FileName                    Status      Comment
--------                    ------      ------------
C:\Projects\Project1.docx   Success
C:\Projects\Datasheet.pdf   Success
C:\Projects\Image.jpg       Success
C:\Projects\Analysis.xlsx   Skipped    No label to apply
C:\Projects\Dashboard.xlsx  Success

Ez a parancs egy "General" nevű címkét állít be a Projektek mappa összes fájljára és annak almappáira.

Ha az Általános címke titkosítás alkalmazására van konfigurálva, az ezzel a paranccsal sikeresen címkézett fájlok is titkosítva lesznek. 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.

Ebben a példában egy fájl nem lett címkézve (kihagyva), mert indoklást igényelt. Ez lehet a kívánt eredmény annak biztosítására, hogy egy magasabb besorolási címkével vagy védelemmel rendelkező fájl véletlenül ne legyen felülírva alacsonyabb besorolási címkével, vagy hogy a védelem el legyen távolítva.

A védelem engedélyezéséhez a Office 365 besorolási címke szabályzatát úgy kell konfigurálni, hogy indokolni lehessen a címke eltávolítását vagy a besorolás csökkentésének szükségességét. Amikor ezt a parancsot az JustificationMessage paraméter nélkül futtatja, és a címke indoklást vált ki, a program kihagyja a fájlt a "Nincs alkalmazandó címke" megjegyzéssel.

4. példa: Az "Általános" címke alkalmazása egyetlen fájlra, amely indoklást igényel

PS C:\> Set-FileLabel -Path \\Finance\Projects\Analysis.xlsx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -JustificationMessage 'The previous label no longer applies'
FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

Ez a parancs az "Általános" címkét állítja be egy olyan fájlhoz, amely már magasabb bizalmassági címkével van felcímkézve. A bizalmassági címke szabályzata úgy van konfigurálva, hogy meg kell indokolnia a címke eltávolítását vagy a besorolás csökkentésének szükségességét. Mivel a parancs indoklási üzenetet tartalmaz, az új címke alkalmazása sikeresen megtörtént.

5. példa: Fájl védelme egyéni engedélyekkel

PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
PS C:\> Set-FileLabel C:\Projects\Analysis.docx -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Az első parancs létrehoz egy alkalmi védelmi szabályzatobjektumot, amely a különböző szervezetek felhasználóinak használati jogosultságokat biztosít a Véleményező engedélyeiből, és lejárati dátumot is alkalmaz.

A második parancs egyetlen ,Analysis.docx nevű fájlt véd a tárolt alkalmi védelmi szabályzatobjektum egyéni engedélyeinek használatával.

6. példa: Címke és egyéni engedélyek alkalmazása a fájlra

PS C:\> $permissions = New-CustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer 
PS C:\> Set-FileLabel C:\Projects\Analysis.docx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Az első parancs létrehoz egy alkalmi védelmi szabályzatobjektumot, amely a különböző szervezetek felhasználóinak használati jogosultságokat biztosít a Véleményező engedélyeiből, és lejárati dátumot is alkalmaz.

A második parancs egyetlen Analysis.docx nevű fájlra alkalmaz címkét, és a tárolt alkalmi védelmi szabályzat objektum egyéni engedélyeinek használatával is védi a fájlt. Ha a címke védelmi beállításokra van konfigurálva, azokat az egyéni engedélyek váltják fel.

7. példa: Egy mappában és annak almappáiban lévő összes fájl vizsgálata, és címkék alkalmazása az automatikus címkézés konfigurált feltételeinek megfelelően

PS C:\> Set-FileLabel -AutoLabel -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 lévő összes fájlt, és az automatikus címkézési szabályzat 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 címkézé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 Pricelist.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ás dátuma változatlan marad.

8. példa: Vizsgálja meg egy mappa összes fájlját és annak almappáit, és alkalmazza a címkéket az automatikus címkézés konfigurált feltételeinek megfelelően, felülírva a meglévő címkéket

PS C:\> Set-FileLabel -Autolabel -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, mivel a Projektek mappában lévő összes fájlt és annak almappáit 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, a Dashboard.xlsxés a 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.

9. példa: Fájl vizsgálata WhatIf módban az összes ismert bizalmas adattípushoz

PS C:\> Set-FileLabel -AutoLabel -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.

10. példa: Fájl vizsgálata WhatIf módban adott bizalmas információtípusok keresése

PS C:\> Set-FileLabel -AutoLabel -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.

11. példa: Fájl vizsgálata WhatIf módban adott bizalmas adattípusok keresése és a talált értékek megjelenítése

PS C:\> $x=Set-FileLabel -AutoLabel -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 észleli 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 parancsot a rendszer a megfeleltethető információtípusok tartalmának megjelenítésére használja, 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

-AutoLabel

Az -AutoLabel használata esetén a parancsmag automatikus címkézési módban fut. Ha az -AutoLabel parancsmag nincs használatban, manuális címkézési módban fut.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CustomPermissions

Megadja azt a változónevet, amely a New-CustomPermissions parancsmaggal létrehozott alkalmi védelmi szabályzatot tárolja. Az alkalmi védelmi szabályzat a fájl vagy fájlok egyéni engedélyekkel való védelmére szolgál.

Típus:	AIPCustomPermissions
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DiscoveryInfoTypes

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 információtípusok Exchange Server listában talál.

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

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Force

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-JustificationMessage

A besorolási címke csökkentésének, a címke eltávolításának vagy a védelem eltávolításának indoklása, ha a bizalmassági szabályzat megköveteli, hogy a felhasználók megoják ezeket az információkat. Ha egy címke beállítása elindítja az indoklást, és ez az ok nincs megadva, a címke nem lesz alkalmazva. Ebben az esetben a visszaadott állapot „Skipped” (Kihagyva) lesz, a megjegyzésben pedig a „Justification required” (Indoklás szükséges) üzenet áll majd.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-LabelId

Az alkalmazandó címke identitását (azonosítóját) adja meg. Ha egy címke alcímkével rendelkezik, mindig csak egy alcímke azonosítóját adja meg, nem pedig a szülőcímkét.

A címkeazonosító megkeresése:

A címkeazonosító értéke nem jelenik meg a Microsoft Purview megfelelőségi portál. Az alábbi Office 365 Security & Compliance Center PowerShell-paranccsal azonban megtalálhatja ezt az értéket:Get-Label | Format-Table -Property DisplayName, Name, Guid

Címkékkel ellátott fájlok esetén a Get-FileStatus parancsmagot is futtatva azonosíthatja a címkeazonosítót (MainLabelId vagy SubLabelId).

Típus:	Guid
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Owner

Megadja a tulajdonost, aki címkét vagy védelmet alkalmaz a fájlra.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 a következők támogatottak:

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

Például:

• C:\Mappa\
• C:\Mappa\Fájlnév
• \\Kiszolgáló\Mappa
• http://sharepoint.contoso.com/Shared%20Documents/Folder

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

-PreserveFileDetails

Adja meg ezt a paramétert, hogy a módosított dátumot (Windows és SharePoint) változatlanul hagyja a címkével ellátott dokumentumokban:

• Helyi vagy hálózati fájlok esetében a Dátum módosítása érték változatlan marad.

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

System.String[]

Kimenetek

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Kapcsolódó hivatkozások

• Get-FileStatus
• New-CustomPermissions
• Set-Authentication