Remove-FileLabel

  • Référence
Module:
PurviewInformationProtection

Supprime l’étiquette de confidentialité d’un fichier ou supprime la protection en fonction de la configuration de l’étiquette ou des autorisations personnalisées.

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

Pour le client Protection des données Microsoft Purview, l’applet de commande Remove-FileLabel supprime une étiquette de confidentialité pour un ou plusieurs fichiers.

Exemples

Exemple 1 : Supprimer une étiquette d’un fichier

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

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

Cette commande supprime l’étiquette existante du fichier nommé C:\Projects\Analysis.docxet spécifie un message de justification obligatoire.

Cette méthode de justification est requise, car le paramètre de stratégie d’étiquette de confidentialité approprié est activé pour exiger la justification de la suppression d’une étiquette.

Notes

Si l’étiquette que vous supprimez protégeait votre fichier à l’aide d’un modèle, cette commande supprime à la fois l’étiquette et la protection.

Si l’étiquette que vous supprimez protégeait votre fichier à l’aide d’autorisations personnalisées, cette commande supprime uniquement l’étiquette.

Exemple 8 : Supprimer la protection d’un fichier

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

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

Cette commande supprime la protection d’un fichier unique nommé Analysis.docx.

Exemple 9 : supprimer la protection et une étiquette d’un fichier

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

Cette commande supprime l’étiquette et la protection personnalisée d’un fichier unique nommé Analysis.docx. Étant donné que la stratégie est configurée pour exiger une justification pour supprimer une étiquette, la raison de la justification est également fournie afin que la commande puisse se terminer sans demander à l’utilisateur de la raison.

Paramètres

-JustificationMessage

Motif de justification de la suppression d’une étiquette ou de la suppression de la protection si la stratégie d’étiquetage de confidentialité exige que les utilisateurs fournissent ces informations. Si la suppression d’une étiquette déclenche la justification et que cette raison n’est pas fournie, l’étiquette n’est pas supprimée. Dans cet exemple, l’état retourné est « Ignoré » avec le commentaire « Justification obligatoire ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie un chemin d’accès local, un chemin d’accès réseau ou une URL SharePoint Server vers les fichiers pour lesquels vous souhaitez supprimer l’étiquette et les informations de protection.

Les caractères génériques ne sont pas pris en charge, ni les emplacements WebDav.

Pour les chemins SharePoint, les éléments suivants sont pris en charge :

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

Par exemple :

Les chemins d’accès peuvent inclure des espaces lorsque vous placez la valeur du chemin d’accès entre guillemets.

Type:String[]
Alias:FullName, FileName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PreserveFileDetails

Spécifiez ce paramètre pour laisser la date de modification (Windows et SharePoint) et les valeurs modifiées par (SharePoint) inchangées pour les documents que vous étiquetez :

  • Pour les fichiers locaux ou réseau, la valeur Date de modification reste inchangée.

  • Pour les fichiers SharePoint, les valeurs Date de modification et Modifié par restent inchangées.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveLabel

Supprime toute étiquette qui a été appliquée à un fichier.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveProtection

Supprime la protection d’un fichier. Si le fichier est étiqueté, l’étiquette n’est pas supprimée.

Vous devez disposer de droits d’utilisation suffisants ou être un super utilisateur pour votre organization de supprimer la protection des fichiers. Pour plus d’informations, consultez Configuration de super utilisateurs pour les services de Azure Rights Management et de découverte ou la récupération de données.

Utilisez l’applet de commande PowerShell Remove-FileLabel pour activer la suppression de la protection des fichiers conteneur (zip, .rar, .7z et .pst).

Notes

  • Cette fonctionnalité de suppression de protection est désactivée par défaut et doit d’abord être activée à l’aide de l’applet de commande Set-LabelPolicy .

  • Pour les fichiers .pst, 5 Go est la taille de fichier maximale prise en charge avec cette applet de commande.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.String[]

Sorties

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult