Dela via

Remove-FileLabel

  • Referens
Modul:
PurviewInformationProtection

Tar bort känslighetsetiketten för en fil eller tar bort skyddet enligt etikettkonfigurationen eller anpassade behörigheter.

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

För Microsoft Purview Information Protection-klienten tar cmdleten Remove-FileLabel bort en känslighetsetikett för en eller flera filer.

Exempel

Exempel 1: Ta bort en etikett från en fil

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

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

Det här kommandot tar bort den befintliga etiketten från filen med namnetC:\Projects\Analysis.docxoch anger ett obligatoriskt motiveringsmeddelande.

Den här motiveringsmetoden krävs eftersom den relevanta principinställningen för känslighetsetiketter är aktiverad för att kräva en motivering för att ta bort en etikett.

Anteckning

Om etiketten du tar bort skyddade filen med hjälp av en mall, tar det här kommandot bort både etiketten och skyddet.

Om etiketten du tar bort skyddade filen med anpassade behörigheter tar det här kommandot bara bort etiketten.

Exempel 8: Ta bort skydd från en fil

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

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

Det här kommandot tar bort skyddet från en enda fil med namnet Analysis.docx.

Exempel 9: Ta bort skydd och en etikett från en fil

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

Det här kommandot tar bort etiketten och det anpassade skyddet från en enda fil med namnet Analysis.docx. Eftersom principen är konfigurerad för att kräva motivering för att ta bort en etikett anges även motiveringsorsaken så att kommandot kan slutföras utan att användaren uppmanas av orsaken.

Parametrar

-JustificationMessage

Motiveringen för att ta bort en etikett eller ta bort skyddet om principen för känslighetsetiketter kräver att användarna anger den här informationen. Om du tar bort en etikett utlöser motiveringen och den här orsaken inte anges tas etiketten inte bort. I det här fallet returneras statusen ”Skipped” (Överhoppad) med kommentaren ”Justification required” (Motivering krävs).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en lokal sökväg, nätverkssökväg eller SharePoint Server-URL till de filer som du vill ta bort etikett- och skyddsinformation för.

Jokertecken stöds inte och WebDav-platser stöds inte.

För SharePoint-sökvägar stöds följande:

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

Exempel:

Sökvägar kan innehålla blanksteg när du omger sökvägsvärdet med citattecken.

Typ:String[]
Alias:FullName, FileName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PreserveFileDetails

Ange den här parametern för att lämna det ändrade datumet (Windows och SharePoint) och ändrad av (SharePoint)-värden oförändrade för dokument som du etiketterar:

  • För lokala filer eller nätverksfiler förblir det ändrade värdet för datum oförändrat.

  • För SharePoint-filer förblir värdena Ändrad ochÄndrad av oförändrade.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RemoveLabel

Tar bort alla etiketter som har tillämpats på en fil.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RemoveProtection

Tar bort skydd från en fil. Om filen är märkt tas inte etiketten bort.

Du måste ha tillräckliga användningsrättigheter eller vara en superanvändare för att din organisation ska kunna ta bort skyddet från filer. Mer information finns i Konfigurera superanvändare för Azure Rights Management och identifieringstjänster eller dataåterställning.

Använd PowerShell-cmdleten Remove-FileLabel för att aktivera borttagning av skydd från containerfiler (zip, .rar, .7z och .pst).

Anteckning

  • Den här funktionen för att ta bort skydd är inaktiverad som standard och måste först aktiveras med cmdleten Set-LabelPolicy .

  • För .pst-filer är 5 GB den maximala filstorlek som stöds med den här cmdleten.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

System.String[]

Utdata

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult