Remove-FileLabel
Entfernt die Vertraulichkeitsbezeichnung für eine Datei oder entfernt den Schutz gemäß der Bezeichnungskonfiguration oder benutzerdefinierten Berechtigungen.
Syntax
RemoveLabel
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-PreserveFileDetails]
RemoveLabelProtection
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-RemoveProtection]
[-PreserveFileDetails]
RemoveProtection
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveProtection]
[-PreserveFileDetails]
Beschreibung
Für den Microsoft Purview Information Protection-Client entfernt das Cmdlet Remove-FileLabel eine Vertraulichkeitsbezeichnung für eine oder mehrere Dateien.
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
Mit diesem Befehl wird die vorhandene Bezeichnung aus der Datei mit dem Namen C:\Projects\Analysis.docxentfernt und eine obligatorische Begründungsmeldung angegeben.
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 schützte, entfernt dieser Befehl sowohl die Bezeichnung als auch den Schutz.
Wenn die bezeichnung, die Sie entfernen, ihre Datei mit benutzerdefinierten Berechtigungen schützte, 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:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'
FileName Status Comment
-------- ------ ------------
C:\Projects\Analysis.docx Success
Mit diesem Befehl wird 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, damit der Befehl abgeschlossen werden kann, ohne den Benutzer aus dem Grund aufzufordern.
Parameter
-JustificationMessage
Der Begründungsgrund für das Entfernen einer Bezeichnung oder zum Entfernen des Schutzes, wenn die Richtlinie für Vertraulichkeitsbezeichnungen benutzer zum Bereitstellen dieser Informationen benötigt. Wenn das Entfernen einer Bezeichnung die Begründung auslöst und dieser Grund nicht angegeben wird, wird die Bezeichnung nicht entfernt. In diesem Fall ist der zurückgegebene Status "Übersprungen" mit dem Kommentar "Begründung erforderlich".
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt einen lokalen Pfad, einen Netzwerkpfad oder eine SharePoint Server-URL zu den Dateien an, für die Sie die Bezeichnungs- und Schutzinformationen entfernen möchten.
Wildcards werden nicht unterstützt, und WebDav-Speicherorte werden nicht unterstützt.
Für SharePoint-Pfade werden folgende Optionen 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 in Anführungszeichen setzen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Vollständiger Name, Dateiname |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PreserveFileDetails
Geben Sie diesen Parameter an, um das Änderungsdatum (Windows und SharePoint) zu belassen und von (SharePoint) geänderten Werten für Dokumente, die Sie beschriften, unverändert zu lassen:
Bei lokalen oder Netzwerkdateien bleibt der Änderungswert "Datum " unverändert.
Für SharePoint-Dateien bleiben das Änderungsdatum und " Geändert durch Werte" unverändert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RemoveLabel
Entfernt alle Bezeichnungen, die auf eine Datei angewendet wurden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
RemoveLabel
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
RemoveLabelProtection
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RemoveProtection
Entfernt den Schutz einer Datei. Wenn die Datei beschriftet ist, wird die Bezeichnung nicht entfernt.
Sie müssen über ausreichende Nutzungsrechte verfügen oder ein Superbenutzer für Ihre Organisation sein, um den Schutz von Dateien zu entfernen. Weitere Informationen finden Sie unter Konfigurieren von Superbenutzern für Azure Rights Management- und Discoverydienste oder Datenwiederherstellung.
Verwenden Sie das PowerShell-Cmdlet Remove-FileLabel , um das Entfernen des Schutzes von Containerdateien (ZIP, .rar, .7z und PST) zu ermöglichen.
Hinweis
Diese Entfernenschutzfunktion ist standardmäßig deaktiviert und muss zuerst mithilfe des Cmdlets Set-LabelPolicy aktiviert werden.
Bei PST-Dateien ist 5 GB die maximale Dateigröße, die mit diesem Cmdlet unterstützt wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
RemoveLabelProtection
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
RemoveProtection
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |