Set-AIPFileLabel

  • Referencia
Modul:
AzureInformationProtection

Beállít vagy eltávolít egy Azure-Information Protection címkét egy fájlhoz, és beállítja vagy eltávolítja a védelmet a címke konfigurációjának vagy egyéni engedélyeinek megfelelően.

Syntax

Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-PreserveFileDetails]
   [-EnableTracking]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Description

Az AIP egységes címkézési ügyfél esetében a Set-AIPFileLabel parancsmag beállít vagy eltávolít egy bizalmassági címkét egy vagy több fájlhoz. 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-AIPCustomPermissions parancsmaggal alkalmi védelmi házirend-objektumként jönnek létre.

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

Ezt a parancsmagot nem interaktív módon futtathatja. További információ: Unified labeling client admin guide (Egységes címkézési ügyfél rendszergazdai útmutatója).

Megjegyzés

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

Példák

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

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -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 a Get-AIPFileStatus parancsmaggal nem címkézett összes fájlt. Ezután ezeket a fájlokat úgy címkézik, hogy azonosítójuk alapján megadja az "Általános" címkét.

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-AIPFileStatus | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -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 a Get-AIPFileStatus parancsmaggal megkeresi a nem címkézett fájlokat. 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, így a Get-Child-Item használható a Get-AIPFileStatus paranccsal.

3. példa: (csak egyesített címkézési ügyfél) Alkalmazza az "Általános" címkét egy mappa összes fájljára és annak almappáira

PS C:\> Set-AIPFileLabel -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 beállít egy "General" nevű címkét 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, akkor 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 meg kellett indokolni. 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 megindokolja a címke eltávolítását vagy a besorolás csökkentésé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: (csak egyesített címkézési ügyfél) Alkalmazza az "Általános" címkét egyetlen fájlra, amely indoklást igényel

PS C:\> Set-AIPFileLabel -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 beállítja az "Általános" címkét egy olyan fájlhoz, amely már magasabb besorolási címkével van megjelölve. A Office 365 besorolási címke szabályzata úgy van konfigurálva, hogy megindokolja a címke eltávolítását vagy a besorolás csökkentését. Mivel a parancs indoklási üzenetet tartalmaz, az új címke alkalmazása sikeresen megtörtént.

5. példa: (csak egyesített címkézési ügyfél) Címke eltávolítása egy fájlból

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'

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

Ez a parancs eltávolítja a meglévő címkét a C:\Projects\Analysis.docxnevű fájlból, és kötelező indoklási üzenetet ad meg.

Ez az indoklási módszer azért szükséges, mert a megfelelő Office 365 besorolási címkeházirend-beállítás lehetővé teszi a címke eltávolításának vagy a besorolás csökkentésének indoklását.

Megjegyzés

Ha az eltávolítani kívánt címke egy sablonnal védte a fájlt, ez a parancs mind a címkét, mind a védelmet eltávolítja.

Ha az eltávolítani kívánt címke egyéni engedélyekkel védte a fájlt, ez a parancs csak a címkét távolítja el.

6. példa: (csak egyesített címkézési ügyfél) Fájl védelme egyéni engedélyekkel

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

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

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

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

7. példa: (csak egyesített címkézési ügyfél) Címke és egyéni engedélyek alkalmazása a fájlra

PS C:\> $permissions = New-AIPCustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer 
PS C:\> Set-AIPFileLabel 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 ad-hoc védelmi szabályzatobjektumot, amely különböző szervezetek felhasználóinak biztosít használati jogosultságokat a Véleményezői engedélyekből, és lejárati dátumot is alkalmaz.

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

8. példa: (csak egyesített címkézési ügyfél) Védelem eltávolítása egy fájlból

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection

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

Ez a parancs egyetlen Analysis.docxnevű fájlból távolítja el a védelmet.

9. példa: (csak egyesített címkézési ügyfél) Védelem és címke eltávolítása egy fájlból

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

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

Ez a parancs eltávolítja a címkét és az egyéni védelmet egyetlen ,Analysis.docxnevű fájlból. Mivel a szabályzat úgy van konfigurálva, hogy indoklást követeljen meg egy címke eltávolításához, az indoklás oka is meg van adva, hogy a parancs befejeződjön anélkül, hogy a felhasználót az okból kérné.

Paraméterek

-CustomPermissions

Megadja azt a változónevet, amely a New-AIPCustomPermissions 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 történő védelmére szolgál.

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

-EnableTracking

Ezt a paramétert megadva regisztrálhat egy védett dokumentumot a dokumentumkövetési portálon.

A parancsmagot és a globális rendszergazdákat futtató felhasználó ezután nyomon követheti a védett dokumentumot, és szükség esetén visszavonhatja azt. A dokumentumkövetési webhelyről a rendszergazdai útmutató dokumentumkövetésének konfigurálása és használata az Azure Information Protection-ban című témakörben talál további információt.

Ha a címke nem alkalmaz védelmet, a rendszer figyelmen kívül hagyja ezt a paramétert.

Type:SwitchParameter
Position:named
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. Ebben az esetben a visszaadott állapot „Skipped” (Kihagyva) lesz, a megjegyzésben pedig a „Justification required” (Indoklás szükséges) üzenet áll majd.

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

-LabelId

Megadja az alkalmazandó címke identitását (azonosítóját). 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 365 Megfelelőségi központban. Az alábbi Office 365 Security & Compliance Center PowerShell-paranccsal azonban megkeresheti ezt az értéket:Get-Label | Format-Table -Property DisplayName, Name, Guid

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

Type:Guid
Position:Named
Default value:None
Required:True
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 a következők támogatottak:

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

Például:

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.

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

-PreserveFileDetails

Adja meg ezt a paramétert, ha a módosított dátumot (Windows és SharePoint) változatlanul szeretné hagyni a címkével ellátott dokumentumok esetében:

  • Helyi vagy hálózati fájlok esetében a Módosítás dátuma é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.

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

-RemoveLabel

Eltávolítja a fájlra alkalmazott címkéket.

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

-RemoveProtection

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

Eltávolítja a védelmet egy fájlból. Ha a fájl címkével van ellátva, a címke nem lesz eltávolítva.

A fájlok védelmének eltávolításához megfelelő használati jogosultságokkal kell rendelkeznie, vagy felügyelő felhasználónak kell lennie a szervezet számára. További információ: Felügyelők konfigurálása Azure Tartalomvédelmi szolgáltatások és felderítési szolgáltatásokhoz vagy adat-helyreállításhoz.

A Set-AIPFileLabel PowerShell-parancsmaggal eltávolíthatja a védelmet a tárolófájlokból (zip, .rar, .7z és .pst).

Megjegyzés

  • Ez az eltávolítási védelmi funkció alapértelmezés szerint le van tiltva, és először engedélyezni kell a Set-LabelPolicy parancsmaggal.

  • .pst fájlok esetén az 5 GB a parancsmag által támogatott maximális fájlméret.

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

Bevitelek

System.String[]

Kimenetek

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult