Partager via


Add-ContentFilterPhrase

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-22

La cmdlet Add-ContentFilterPhrase permet de définir des mots personnalisés pour l'Agent de filtrage de contenu. Un mot personnalisé est un mot ou une phrase que l'administrateur définit pour permettre à l'Agent de filtrage de contenu d'évaluer le contenu d'un message électronique et d'appliquer un traitement de filtre approprié.

Syntaxe

Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour personnaliser la manière dont l'Agent de filtrage de contenu affecte des seuils de probabilité de courier indésirable en identifiant des mots ou des phrases approuvés ou non approuvés, vous devez commencer par définir des mots personnalisés.

Une propriété requise pour un mot ou une phrase personnalisé est le paramètre Influence. Le paramètre Influence prend l'une des deux valeurs suivantes : GoodWord ou BadWord.

Un message contenant un mot ou une phrase personnalisé dont le paramètre Influence a la valeur GoodWord reçoit automatiquement un contrôle d'accès SCL 0 et ignore donc le traitement de courrier indésirable en aval. Un message contenant un mot ou une phrase personnalisé dont le paramètre Influence a la valeur BadWord reçoit automatiquement un seuil de probabilité de courier indésirable 9 et est donc traité comme du courrier indésirable en vertu des stratégies que vous avez configurées dans Microsoft Exchange Server 2007.

Vous pouvez entrer des mots ou des phrases personnalisés dans une combinaison quelconque de lettres majuscules et minuscules. Toutefois, si l'Agent de filtrage de contenu évalue un contenu de message, il ignore la casse. Le nombre maximal de mots et de phrases personnalisés qu'il est possible de créer est de 800.

Pour plus d'informations sur la modification de l'Agent de filtrage de contenu, consultez la rubrique Set-ContentFilterConfig.

Pour exécuter la cmdlet Add-ContentFilterPhrase, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour exécuter la cmdlet Add-ContentFilterPhrase sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Influence

Obligatoire

Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence

Les valeurs valides sont GoodWord et BadWord.

Phrase

Obligatoire

System.String

Lorsque vous transmettez un argument, vous devez placer le paramètre Phrase entre guillemets si la phrase contient des espaces, comme suit : "This is a bad phrase". Les expressions personnalisées doivent être d'une longueur inférieure à 257 caractères.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance ADAM locale.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

  

Exemple

L'exemple de code suivant montre une commande Add‑ContentFilterPhrase qui définit un mot personnalisé qui est la phrase BadWord, This is a bad phrase.

Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord