Set-DataClassification
Cette applet de commande est fonctionnelle uniquement dans Exchange local.
Dans Exchange Online, cette applet de commande est 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.
Syntaxe
Default (Par défaut)
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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-*) comportent 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.
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 |
| Alias: | cf |
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 |
-Description
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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 |
-DomainController
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 ».
Propriétés du paramètre
| Type: | Fqdn |
| 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 |
-Fingerprints
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| 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 |
-Identity
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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é
Propriétés du paramètre
| Type: | DataClassificationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-IsDefault
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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 |
-Locale
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 de Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez Classe CultureInfo.
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.
Propriétés du paramètre
| Type: | CultureInfo |
| 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 |
-Name
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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 |
-WhatIf
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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 |
| Alias: | Wi |
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 |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.