Set-DataClassification

Cette applet de commande est fonctionnelle uniquement dans Exchange local.

Dans Exchange Online, cette applet de commande a été remplacée par l’applet de commande Set-DlpSensitiveInformationType dans Security & Compliance PowerShell.

La cmdlet Set-DataClassification permet de modifier des règles de classification des données qui utilisent des empreintes digitales document.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-DataClassification
   [-Identity] <DataClassificationIdParameter>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsDefault]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Les packages de règle de classification sont utilisés par la prévention des pertes de données (DLP) pour détecter les contenus sensibles dans les messages.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-DataClassification "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

Cet exemple ajoute une traduction française à la règle de classification des données existante nommée « Contoso Confidential » et définit cette traduction française comme version par défaut.

Exemple 2

Set-DataClassification "Contoso Confidential" -Locale es -Name $null -Description $null

Cet exemple supprime la traduction espagnole existante de la règle de classification des données nommée « Contoso Confidential ».

Exemple 3

$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')

$Benefits_Fingerprint = New-Fingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"

$Contoso_Confidential = Get-DataClassification "Contoso Confidential"

$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)

$Array.Add($Benefits_FingerPrint)

Set-DataClassification $Contoso_Confidential.Identity -FingerPrints $Array

Cet exemple modifie la règle de classification des données existante nommée « Contoso Confidential » en ajoutant une nouvelle empreinte digitale pour le fichier C:\My Documents\Contoso Benefits Template.docx, sans affecter les empreintes digitales document déjà définies.

Exemple 4

$cc = Get-DataClassification "Contoso Confidential"

$a = [System.Collections.ArrayList]($cc.Fingerprints)

$a

$a.RemoveAt(0)

Set-DataClassification $cc.Identity -FingerPrints $a

Cet exemple modifie la règle de classification des données nommée « Contoso Confidential » en supprimant une empreinte digitale document existante sans affecter les autres empreintes déjà définies.

Les trois premières commandes retournent la liste des empreintes digitales du document dans la classification des données. La première empreinte digitale document de la liste porte le numéro d’index 0, la deuxième a le numéro d’index 1, et ainsi de suite. Le numéro d’index vous permet de spécifier l’empreinte de document que vous souhaitez supprimer. Les deux dernières commandes suppriment la première empreinte digitale du document qui s’affiche dans la liste.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Description

Le paramètre Description permet d’indiquer une description de la règle. Utilisez le paramètre Description avec les paramètres Locale et Name pour spécifier les descriptions de la règle de classification des données dans différentes langues. Les valeurs localisées pour Description apparaissent dans la propriété AllLocalizedDescriptions de la règle de classification des données.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fingerprints

Le paramètre Fingerprints spécifie les fichiers codés en octets qui sont utilisés comme empreintes digitales par la règle de classification des données. Pour obtenir des instructions sur l’importation de documents à utiliser comme modèles pour les empreintes digitales, consultez Nouvelle empreinte digitale ou la section Exemples. Pour obtenir des instructions sur la façon d’ajouter et de supprimer des empreintes digitales document à partir d’une règle de classification des données existante, consultez la rubrique Examples.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Le paramètre Identity spécifie la règle de classification des données à modifier. Vous pouvez utiliser une valeur quelconque qui identifie de façon unique la règle de classification des données. Par exemple :

  • Nom
  • LocalizedName
  • Valeur GUID d’identité
Type:DataClassificationIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IsDefault

Le commutateur IsDefault est utilisé avec le paramètre Locale pour spécifier la langue par défaut de la règle de classification des données. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

La valeur Locale par défaut est stockée dans la propriété DefaultCulture.

Lorsque vous modifiez la valeur Locale par défaut, la valeur Name de la règle de classification des données est modifiée pour correspondre à la valeur Name associée aux nouveaux paramètres régionaux par défaut. La valeur Name d’origine, définie lors de la création de la règle, est stockée de manière permanente dans la propriété LocalizedName.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Locale

Le paramètre Locale permet d’ajouter ou de supprimer des langues associées à la règle de classification des données.

L’entrée valide pour ce paramètre est une valeur de code de culture prise en charge à partir de la classe CultureInfo Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez CultureInfo, classe.

En règle générale, le paramètre Locale est utilisé avec les paramètres Name et Description pour ajouter ou supprimer des noms et des descriptions traduites à la règle de classification des données. Vous pouvez également utiliser le paramètre Locale avec le commutateur IsDefault pour définir un nom et une description traduits existants comme valeur par défaut. Pour supprimer la traduction par défaut, vous devez d’abord définir une autre traduction comme valeur par défaut.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

Le paramètre Name permet de spécifier le nom de la règle de classification des données. La valeur doit compter moins de 256 caractères.

Utilisez le paramètre Name avec les paramètres Locale et Description pour attribuer des noms à la règle de classification des données dans différentes langues. Les valeurs localisées pour Name apparaissent dans la propriété AllLocalizedNames de la règle de classification des données.

La valeur du paramètre Name est utilisée dans le conseil de stratégie présenté aux utilisateurs dans Outlook sur le web. Quand une valeur traduite du paramètre Name correspond à la langue du client, le conseil de stratégie est affiché dans la langue du client. Si aucune valeur traduite du paramètre Name ne correspond à la langue du client, la traduction par défaut spécifiée par le paramètre IsDefault est utilisée pour le conseil de stratégie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.