Remove-FileLabel
Eltávolítja egy fájl bizalmassági címkéjét, vagy eltávolítja a védelmet a címke konfigurációjának vagy egyéni engedélyeinek megfelelően.
Syntax
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-PreserveFileDetails]
[<CommonParameters>]
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-RemoveProtection]
[-PreserveFileDetails]
[<CommonParameters>]
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveProtection]
[-PreserveFileDetails]
[<CommonParameters>]
Description
A Microsoft Purview információvédelem-ügyfél esetében a Remove-FileLabel parancsmag eltávolít egy vagy több fájl bizalmassági címkéjét.
Példák
1. példa: Címke eltávolítása fájlból
PS C:\> Remove-FileLabel 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.
Erre az indoklási módszerre azért van szükség, mert a megfelelő bizalmassági címkeházirend-beállítás lehetővé teszi a címke eltávolításának 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.
8. példa: Védelem eltávolítása egy fájlból
PS C:\> Remove-FileLabel 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: 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
-JustificationMessage
A címke eltávolításának vagy a védelem eltávolításának indoklása, ha a bizalmassági címkézési szabályzat megköveteli, hogy a felhasználók megadják ezeket az információkat. Ha egy címke eltávolítása kiváltja az indoklást, és nem adja meg ezt az okot, a címke nem lesz eltávolítva. 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 |
-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, amelyekről el szeretné távolítani a címkét és a védelmi információkat.
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
- \\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.
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, 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RemoveLabel
Eltávolítja a fájlra alkalmazott címkéket.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RemoveProtection
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 Remove-FileLabel 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.
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