Set-DlpKeywordDictionary

Référence

Module:: ExchangePowerShell

S’applique à:: Security & Compliance

Cette applet de commande est disponible uniquement dans & Security Compliance PowerShell. Pour plus d’informations, consultez Conformité de la sécurité & PowerShell.

Utilisez l’applet de commande Set-DlpKeywordDictionary pour modifier les dictionnaires de mots clés de protection contre la perte de données (DLP) dans le portail de conformité Microsoft Purview.

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-DlpKeywordDictionary
   [-Identity] <SensitiveInformationTypeIdParameter>
   [-Confirm]
   [-Description <String>]
   [-FileData <Byte[]>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Pour utiliser cette applet de commande dans PowerShell de conformité de la sécurité & , des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.

Exemples

Exemple 1

$Keywords = "Aarskog's syndrome, Abandonment, Abasia, Abderhalden-Kaufmann-Lignac, Abdominalgia, Abduction contracture, Abetalipo proteinemia, Abiotrophy, Ablatio, ablation, Ablepharia, Abocclusion, Abolition, Aborter, Abortion, Abortus, Aboulomania, Abrami's disease, Abramo"

$EncodedKeywords = [System.Text.Encoding]::Unicode.GetBytes($keywords)

Set-DlpKeywordDictionary -Identity "Diseases" -FileData $EncodedKeywords

Cet exemple remplace les termes existants dans le dictionnaire de mots clés DLP nommé Diseases par les valeurs spécifiées.

Exemple 2

$Dictionary = Get-DlpKeywordDictionary -Name "Diseases"

$Terms = $Dictionary.KeywordDictionary.split(',').trim()

$Terms += "Achylia","Acidemia","Acidocytopenia","Acidocytosis","Acidopenia","Acidosis","Aciduria","Acladiosis","Aclasis"

$Keywords = $Terms -Join ", "

$EncodedKeywords = [System.Text.Encoding]::Unicode.GetBytes($Keywords)

Set-DlpKeywordDictionary -Identity "Diseases" -FileData $EncodedKeywords

Cet exemple montre comment ajouter les termes spécifiés au dictionnaire de mots clés DLP nommé Diseases sans affecter les autres termes existants.

Exemple 3

$Dictionary = Get-DlpKeywordDictionary -Name "Diseases"

$Terms = $Dictionary.KeywordDictionary.split(',').trim()

$TermsToRemove = @('abandonment', 'ablatio')

$UpdatedTerms = $Terms | Where-Object {$_ -NotIn $TermsToRemove}

$Keywords = $UpdatedTerms -Join ", "

$EncodedKeywords = [System.Text.Encoding]::Unicode.GetBytes($Keywords)

Set-DlpKeywordDictionary -Identity "Diseases" -FileData $EncodedKeywords

Cet exemple supprime les termes spécifiés du dictionnaire de mots clés DLP nommé Diseases sans affecter les autres termes existants.

Exemple 4

$Dictionary = Get-DlpKeywordDictionary -Name "Inappropriate Language"

$Terms = $Dictionary.KeywordDictionary.split(',').trim()

Set-Content $Terms -Path "C:\My Documents\InappropriateTerms.txt"

$UpdatedTerms = Get-Content -Path "C:\My Documents\InappropriateTerms.txt"

$Keywords = $UpdatedTerms -Join ", "

$EncodedKeywords = [System.Text.Encoding]::Unicode.GetBytes($Keywords)

Set-DlpKeywordDictionary -Identity "Inappropriate Language" -FileData $EncodedKeywords

Les trois premières commandes exportent les termes du dictionnaire de mots clés existant nommé Langage inapproprié vers le fichier C:\My Documents\InappropriateTerms.txt, où chaque terme se trouve sur une ligne distincte.

Une fois que vous avez utilisé le Bloc-notes pour modifier les termes et enregistrer le fichier, les quatre dernières commandes utilisent le fichier pour remplacer les termes dans le dictionnaire de mots clés.

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:	Security & Compliance

-Description

Le paramètre Description spécifie un texte qui décrit le dictionnaire de mots clés DLP. Si la valeur contient des espaces, mettez le nom entre guillemets.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-FileData

Le paramètre FileData spécifie les termes utilisés dans le dictionnaire de mots clés DLP. Ce paramètre nécessite une liste séparée par des virgules de valeurs codées en binaire en UTF-16. Pour plus d’informations, consultez les exemples dans cette rubrique.

La taille de fichier maximale est de 1 Mo de termes après compression. La limite d’organisation pour tous les dictionnaires est également de 1 Mo après la compression.

Type:	Byte[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

Le paramètre Identity spécifie le nom du dictionnaire de mots clés DLP que vous souhaitez modifier. Si la valeur contient des espaces, mettez le nom entre guillemets.

Type:	SensitiveInformationTypeIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

Le paramètre Name spécifie un nom unique pour le dictionnaire de mots clés DLP. Si la valeur contient des espaces, mettez le nom entre guillemets.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

Le commutateur WhatIf ne fonctionne pas dans PowerShell conformité de la sécurité & .

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance