Remove-FileLabel

  • Referenz
Modul:
PurviewInformationProtection

Entfernt die Vertraulichkeitsbezeichnung für eine Datei oder entfernt den Schutz gemäß der Bezeichnungskonfiguration oder den benutzerdefinierten Berechtigungen.

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>]

Beschreibung

Für den Microsoft Purview Information Protection-Client entfernt das Cmdlet Remove-FileLabel eine Vertraulichkeitsbezeichnung für mindestens eine Datei.

Beispiele

Beispiel 1: Entfernen einer Bezeichnung aus einer Datei

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

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

Dieser Befehl entfernt die vorhandene Bezeichnung aus der Datei mit dem Namen C:\Projects\Analysis.docxund gibt eine obligatorische Begründungsmeldung an.

Diese Begründungsmethode ist erforderlich, da die entsprechende Richtlinieneinstellung für Vertraulichkeitsbezeichnungen aktiviert ist, um eine Begründung für das Entfernen einer Bezeichnung zu erfordern.

Hinweis

Wenn die Bezeichnung, die Sie entfernen, Ihre Datei mithilfe einer Vorlage geschützt hat, entfernt dieser Befehl sowohl die Bezeichnung als auch den Schutz.

Wenn die Bezeichnung, die Sie entfernen, Ihre Datei mit benutzerdefinierten Berechtigungen geschützt hat, entfernt dieser Befehl nur die Bezeichnung.

Beispiel 8: Entfernen des Schutzes aus einer Datei

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

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

Mit diesem Befehl wird der Schutz aus einer einzelnen Datei mit dem Namen Analysis.docxentfernt.

Beispiel 9: Entfernen des Schutzes und einer Bezeichnung aus einer Datei

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

Mit diesem Befehl werden die Bezeichnung und der benutzerdefinierte Schutz aus einer einzelnen Datei mit dem Namen Analysis.docxentfernt. Da die Richtlinie so konfiguriert ist, dass eine Begründung zum Entfernen einer Bezeichnung erforderlich ist, wird auch der Begründungsgrund angegeben, sodass der Befehl abgeschlossen werden kann, ohne den Benutzer zur Begründung aufzufordern.

Parameter

-JustificationMessage

Der Rechtfertigungsgrund für das Entfernen einer Bezeichnung oder das Entfernen des Schutzes, wenn die Vertraulichkeitsbezeichnungsrichtlinie erfordert, dass Benutzer diese Informationen angeben müssen. Wenn das Entfernen einer Bezeichnung die Begründung auslöst und dieser Grund nicht angegeben wird, wird die Bezeichnung nicht entfernt. In diesem Fall lautet der zurückgegebene Status „Übersprungen“ und enthält den Kommentar „Begründung erforderlich“.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt einen lokalen Pfad, Netzwerkpfad oder SharePoint Server-URL für die Dateien an, für die Sie die Bezeichnung und die Schutzinformationen entfernen möchten.

Platzhalter und WebDav-Speicherorte werden nicht unterstützt.

Für SharePoint-Pfade werden folgende Elemente unterstützt:

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

Beispiel:

Pfade können Leerzeichen enthalten, wenn Sie den Pfadwert mit Anführungszeichen umschließen.

Typ:String[]
Aliase:FullName, FileName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PreserveFileDetails

Geben Sie diesen Parameter an, um die Werte des Änderungsdatums (Windows und SharePoint) und der Änderung durch (SharePoint) für Dokumente, die Sie bezeichnen, unverändert zu lassen:

  • Bei lokalen oder Netzwerkdateien bleibt der Wert vom Datum der Änderung unverändert.

  • Für SharePoint-Dateien bleiben die Werte Geändertes Datum und Geändert von unverändert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveLabel

Entfernt alle Bezeichnungen, die auf eine Datei angewendet wurden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveProtection

Entfernt den Schutz aus einer Datei. Wenn die Datei beschriftet ist, wird die Bezeichnung nicht entfernt.

Sie müssen über ausreichende Nutzungsrechte verfügen oder ein Superbenutzer sein, damit Ihr organization schutz aus Dateien entfernen kann. Weitere Informationen finden Sie unter Konfigurieren von Superbenutzern für Azure Rights Management und Ermittlungsdienste oder Datenwiederherstellung.

Verwenden Sie das PowerShell-Cmdlet Remove-FileLabel , um das Entfernen des Schutzes aus Containerdateien (zip, .rar, .7z und PST) zu aktivieren.

Hinweis

  • Diese Funktion zum Entfernen des Schutzes ist standardmäßig deaktiviert und muss zuerst mithilfe des Cmdlets Set-LabelPolicy aktiviert werden.

  • Für PST-Dateien ist 5 GB die maximale Dateigröße, die mit diesem Cmdlet unterstützt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.String[]

Ausgaben

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult