Sdílet prostřednictvím

Remove-FileLabel

  • Reference
Modul:
PurviewInformationProtection

Odebere popisek citlivosti souboru nebo odebere ochranu podle konfigurace popisku nebo vlastních oprávnění.

Syntaxe

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

U klienta Microsoft Purview Information Protection odebere rutina Remove-FileLabel popisek citlivosti pro jeden nebo více souborů.

Příklady

Příklad 1: Odebrání popisku ze souboru

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

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

Tento příkaz odebere existující popisek ze souboru s názvem C:\Projects\Analysis.docxa určí zprávu o povinném odůvodnění.

Tato metoda zdůvodnění je povinná, protože nastavení zásad popisku citlivosti je povolené tak, aby vyžadovalo odůvodnění pro odebrání popisku.

Poznámka

Pokud popisek, který odebíráte, chránil soubor pomocí šablony, odebere tento příkaz popisek i ochranu.

Pokud popisek, který odebíráte, chránil soubor pomocí vlastních oprávnění, odebere tento příkaz jenom popisek.

Příklad 8: Odebrání ochrany ze souboru

PS C:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveProtection

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

Tento příkaz odebere ochranu z jednoho souboru s názvem Analysis.docx.

Příklad 9: Odebrání ochrany a popisku ze souboru

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

Tento příkaz odebere popisek a vlastní ochranu z jednoho souboru s názvem Analysis.docx. Vzhledem k tomu, že je zásada nakonfigurovaná tak, aby vyžadovala odůvodnění k odebrání popisku, zadá se také důvod odůvodnění, aby se příkaz mohl dokončit, aniž by se uživateli zobrazila výzva k zadání důvodu.

Parametry

-JustificationMessage

Odůvodnění odebrání popisku nebo odebrání ochrany v případě, že zásady popisování citlivosti vyžadují, aby uživatelé tyto informace zadáli. Pokud odebrání popisku aktivuje odůvodnění a tento důvod není zadaný, popisek se neodebere. V tomto případě se vrátí stav Přeskočeno s komentářem Vyžaduje se zdůvodnění.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje místní cestu, síťovou cestu nebo adresu URL serveru SharePoint Server k souborům, pro které chcete odebrat popisek a informace o ochraně.

Zástupné cardy nejsou podporovány a umístění WebDav nejsou podporována.

U sharepointových cest jsou podporovány následující:

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

Příklad:

Cesty můžou obsahovat mezery, když uzavřete hodnotu cesty do uvozovek.

Typ:String[]
Aliasy:FullName, FileName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PreserveFileDetails

Zadáním tohoto parametru ponecháte hodnoty data změny (Windows a SharePoint) a hodnoty změněné uživatelem (SharePoint) u dokumentů, které označíte štítkem:

  • U místních nebo síťových souborů zůstává hodnota Date modified (Datum změny) beze změny.

  • U sharepointových souborů zůstanou hodnoty Datum změny a Autor změny beze změny.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RemoveLabel

Odebere všechny popisky použité u souboru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RemoveProtection

Odebere ochranu ze souboru. Pokud je soubor označený, popisek se neodebere.

Abyste mohli ze souborů odebrat ochranu, musíte mít dostatečná práva k používání nebo být superuživatelem. Další informace najdete v tématu Konfigurace superuživatelů pro službu Azure Rights Management a službu zjišťování nebo pro obnovení dat.

Pomocí rutiny PowerShellu Remove-FileLabel povolte odebrání ochrany ze souborů kontejneru (zip, .rar, .7z a .pst).

Poznámka

  • Tato možnost odebrání ochrany je ve výchozím nastavení zakázaná a musí se nejprve povolit pomocí rutiny Set-LabelPolicy .

  • U souborů .pst je maximální velikost souboru podporovaná touto rutinou 5 GB.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.String[]

Výstupy

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult