Set-ContentFilterConfig

Article
09/30/2014

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

Dernière rubrique modifiée : 2009-05-18

La cmdlet Set-ContentFilterConfig permet de modifier la configuration du filtre de contenu sur un ordinateur sur lequel le rôle serveur de transport Edge ou Hub est installé.

Syntaxe

Set-ContentFilterConfig [-BypassedRecipients <MultiValuedProperty>] [-BypassedSenderDomains <MultiValuedProperty>] [-BypassedSenders <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <ContentFilterConfig>] [-InternalMailEnabled <$true | $false>] [-OutlookEmailPostmarkValidationEnabled <$true | $false>] [-QuarantineMailbox <Nullable>] [-RejectionResponse <AsciiString>] [-SCLDeleteEnabled <$true | $false>] [-SCLDeleteThreshold <Int32>] [-SCLQuarantineEnabled <$true | $false>] [-SCLQuarantineThreshold <Int32>] [-SCLRejectEnabled <$true | $false>] [-SCLRejectThreshold <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette commande modifie la configuration du filtre de contenu.

Pour exécuter la cmdlet Set-ContentFilterConfig, 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 Set-ContentFilterConfig 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 présent sur cet ordinateur.

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

Paramètres

Paramètre	Obligatoire	Type	Description
BypassedRecipients	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre prend les valeurs des adresses SMTP des destinataires de votre organisation. L'agent de filtrage de contenu n'exécute aucun filtrage de contenu pour les messages dont les adresses sont répertoriées dans ce paramètre. Pour entrer plusieurs adresses SMTP, séparez-les par des virgules, comme suit : `recipient1@contoso.com, recipient2@contoso.com` Le nombre maximal de destinataires que vous pouvez entrer est 800.
ByPassedSenderDomains	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre prend les valeurs du nom de domaine des domaines d'envoi. L'agent de filtrage de contenu n'exécute aucun filtrage de contenu pour les messages qui proviennent des domaines répertoriés dans ce paramètre. Pour entrer plusieurs domaines, séparez-les par des virgules, comme suit : `contoso.com, example.com`. Un caractère générique () peut être utilisé pour spécifier tous les sous-domaines, comme suit : .`contoso.com`. Le nombre maximal de domaines que vous pouvez entrer est 800.
ByPassedSenders	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre prend les valeurs des adresses SMTP des expéditeurs. L'agent de filtrage de contenu n'exécute aucun filtrage de contenu pour les messages qui proviennent des adresses répertoriées dans ce paramètre. Pour entrer plusieurs adresses SMTP, séparez-les par des virgules, comme suit : `sender1@contoso.com, sender2@example.com` Le nombre maximal d'adresses SMTP que vous pouvez entrer est 800.
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 sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit uniquement sur l'instance ADAM locale.
Enabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre Enabled est `$true` ou `$false`. Le paramètre par défaut est `$true`. Lorsque le paramètre Enabled à la valeur `$true`, l'agent de filtrage de contenu est activé sur l'ordinateur sur lequel la commande Set-ContentFilterConfig est exécutée.
ExternalMailEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre ExternalMailEnabled est `$true` ou `$false`. Le paramètre par défaut est `$true`. Lorsque le paramètre ExternalMailEnabled a la valeur `$true`, tous les messages provenant de connexions non authentifiées sont transmis via l'agent de filtrage de contenu pour traitement.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig	Le paramètre Instance vous permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.
InternalMailEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre InternalMailEnabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre InternalMailEnabled a la valeur `$true`, tous les messages provenant de connexions authentifiées et de domaines faisant autorité au sein de votre entreprise sont transmis via l'agent de filtrage de contenu pour traitement.
OutlookEmailPostmarkValidationEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre OutlookEmailPostmarkValidationEnabled est `$true` ou `$false`. Lorsque le paramètre OutlookEmailPostmarkValidationEnabled a la valeur `$true`, l'Agent de filtrage de contenu envoie un puzzle de calcul au système de messagerie de l'expéditeur pour traitement. Les résultats de la validation du puzzle sont pris en compte dans le SCL total. Cette fonctionnalité est exposée à l'utilisateur Microsoft Outlook comme validation de cachet de courrier électronique Office Outlook 2007. Le paramètre par défaut est `$false`.
QuarantineMailbox	Facultatif	System.Nullable	Une entrée valide pour le paramètre QuarantineMailbox est une adresse SMTP. Une boîte aux lettres de mise en quarantaine du courrier indésirable est nécessaire lorsque vous définissez le paramètre SCLQuarantineEnabled sur `True`. Tous les messages excédant la valeur définie dans le paramètre SCLQuarantineThreshold sont envoyés vers l'adresse SMTP que vous avez définie dans ce paramètre.
RejectionResponse	Facultatif	Microsoft.Exchange.Data.AsciiString	Ce paramètre est nécessaire lorsque vous définissez le paramètre SCLRejectEnabled comme `True`. Le paramètre RejectionResponse prend une valeur de chaîne. Entrez le corps du message à délivrer dans le notification d'échec de remise (NDR) aux expéditeurs dont les messages sont supérieurs ou égaux à la valeur SCLRejectThreshold. Ne dépassez pas 240 caractères dans l'argument. Lorsque vous transmettez un argument, vous devez placer le paramètre RejectionResponse entre guillemets doubles si la phrase contient des espaces, comme suit : `"Message rejected"`. Le paramètre par défaut est `Message rejected due to content restrictions`.
SCLDeleteEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre SCLDeleteEnabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre SCLDeleteEnabled a la valeur `$true`, tous les messages excédant la valeur définie dans le paramètre SCLDeleteThreshold sont supprimés.
SCLDeleteThreshold	Facultatif	System.Int32	Ce paramètre prend une valeur de nombre entier comprise entre `1` et `9`. Cette valeur représente la valeur de contrôle d'accès SCL qu'un message particulier doit dépasser pour que l'agent de filtrage de contenu le supprime et n'envoie pas de NDR. Pour activer cette fonctionnalité, vous devez définir le paramètre SCLDeleteEnabled comme `True`. Le paramètre par défaut est `9`.
SCLQuarantineEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre SCLQuarantineEnabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre SCLQuarantineEnabled a la valeur `$true`, tous les messages excédant la valeur définie dans le paramètre SCLQuarantineThreshold sont envoyés à la boîte aux lettres de mise en quarantaine du courrier indésirable spécifiée dans le paramètre QuarantineMailbox.
SCLQuarantineThreshold	Facultatif	System.Int32	Ce paramètre prend une valeur de nombre entier comprise entre `1` et `9`. Cette valeur représente la valeur de contrôle d'accès SCL qu'un message particulier doit dépasser pour que l'agent de filtrage de contenu le mette en quarantaine. Pour activer cette fonctionnalité, vous devez définir le paramètre SCLQuarantineEnabled comme `True` et fournir une adresse SMTP valide dans le paramètre QuarantineMailbox. Le paramètre par défaut est `9`.
SCLRejectEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre SCLRejectEnabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre SCLRejectEnabled a la valeur `$true`, tous les messages excédant la valeur définie dans le paramètre SCLRejectThreshold sont rejetés et une notification d'échec de remise est envoyée à l'expéditeur.
SCLRejectThreshold	Facultatif	System.Int32	Ce paramètre prend une valeur de nombre entier comprise entre `1` et `9`. Cette valeur représente la valeur de contrôle d'accès SCL qu'un message particulier doit dépasser pour que l'agent de filtrage de contenu le supprime et envoie une notification d'échec de remise à l'expéditeur. Pour activer la fonctionnalité de suppression, vous devez définir le paramètre SCLDeleteEnabled comme `True`. Vous pouvez également revoir le message de la notification d'échec de remise par défaut en modifiant le paramètre RejectionResponse. Le paramètre par défaut est `9`.
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

Le premier exemple de code montre une commande Set-ContentFilterConfig dont la configuration du filtre de contenu est modifiée de la manière suivante :

Les fonctionnalités du seuil SCL sont activées et configurées pour mettre en quarantaine, rejeter et supprimer les messages.
spamQ@contoso.com devient la boîte aux lettres de mise en quarantaine du courrier indésirable.
Le filtre de contenu est paramétré pour rejeter tous les messages excédant le seuil SCL.
La réponse de rejet est définie.
Deux utilisateurs pour lesquels le filtre de contenu ne doit pas traiter les messages sont définis.

Le second exemple de code montre une commande Set-ContentFilterConfig qui spécifie un domaine d'expéditeur, qui est nommé woodgrovebank.com, dont les messages électroniques entrants contourneront le filtrage de contenu.

Set-ContentFilterConfig -SclQuarantineEnabled:$true -SclRejectEnabled:$true -SclDeleteEnabled:$true -SclQuarantineThreshold 5 -SclRejectThreshold 6 -SclDeleteThreshold 8  -QuarantineMailbox spamQ@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com 
Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com