Set-FileLabel
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 SuccessEz 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 SuccessEz 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 SuccessEz 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 SuccessEz 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 SuccessAz 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 SuccessAz 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 AnticipaAz 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