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“.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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:

C:\Ordner\
C:\Ordner\Dateiname
\\Server\Ordner
http://sharepoint.contoso.com/Shared%20Documents/Folder

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

Type:	String[]
Aliases:	FullName, FileName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLabel

Entfernt alle Bezeichnungen, die auf eine Datei angewendet wurden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.