Partager via


Remove-FileLabel

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

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]

Description

Pour le client Microsoft Purview Information Protection, 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.

Remarque

Si l’étiquette que vous supprimez protège 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ège 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:\> Remove-FileLabel 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 seul fichier nommé Analysis.docx. Étant donné que la stratégie est configurée pour exiger une justification pour supprimer une étiquette, la raison de justification est également fournie afin que la commande puisse s’exécuter sans inviter l’utilisateur pour 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é oblige les utilisateurs à fournir 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 ce cas, l’état retourné est « Ignoré » avec le commentaire « Justification requise ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

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

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

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

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

Par exemple:

  • C :\Folder\
  • C :\Folder\Filename
  • \\Serveur\Dossier
  • http://sharepoint.contoso.com/Shared%20Documents/Folder

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom complet, Nom du fichier

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 de modification date reste inchangée.

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveLabel

Supprime toute étiquette appliquée à un fichier.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

RemoveLabel
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveLabelProtection
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 que votre organisation supprime la protection des fichiers. Pour plus d’informations, consultez Configuration de super utilisateurs pour Azure Rights Management et les services 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).

Remarque

  • 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 sont la taille de fichier maximale prise en charge avec cette applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

RemoveLabelProtection
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveProtection
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

Entrées

System.String

Sorties

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult