Set-AIPFileLabel
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:
- C:\Mappa\
- C:\Mappa\Fájlnév
- \\Server\Folder
- 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.
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