Set-AttachmentFilterListConfig

 

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

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

La cmdlet Set-AttachmentFilterListConfig permet de modifier la configuration de l'agent de filtrage des pièces jointes sur l'ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur de transport Edge est installé.

Syntaxe

set-attachmentfilterlistconfig [-Action <Reject | Strip | SilentDelete>] [-AdminMessage <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionConnectors <MultiValuedProperty>] [-Instance <AttachmentFilteringConfig>] [-RejectResponse <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

L'Agent de filtrage des pièces jointes peut bloquer l'entrée des pièces jointes dans l'organisation Exchange 2007 en fonction du type de contenu et du nom de fichier de la pièce jointe. La cmdlet Set-AttachmentFilterListConfig permet de modifier les informations de configuration pour l'Agent de filtrage des pièces jointes et de gérer le mode de traitement des pièces jointes. Les mêmes options de configuration sont appliquées à toutes les entrées de la liste de filtrage des pièces jointes configurée sur l'ordinateur local sur lequel le rôle serveur de transport Edge est installé. Vous devez configurer séparément chaque ordinateur sur lequel le rôle serveur de transport Edge est installé.

Pour exécuter la cmdlet Set-AttachmentFilterListConfig 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 Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Action

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.FilterActions

Ce paramètre spécifie la manière dont l'Agent de filtrage des pièces jointes gère une pièce jointe correspondant à une entrée de la liste de filtrage des pièces jointes. La valeur par défaut est Block. Les valeurs valides sont les suivantes :

  • Reject   Cette valeur empêche la remise du message électronique et de la pièce jointe au destinataire et envoie une notification d'échec de remise à l'expéditeur.

  • Strip   Cette valeur supprime la pièce jointe incriminée du message électronique et laisse passer le message et d'autres pièces jointes ne correspondant pas à une entrée de la liste de filtrage des pièces jointes. Une notification indiquant que la pièce jointe a été supprimée est ajoutée au message électronique.

  • SilentDelete   Cette valeur empêche la remise du message électronique et de la pièce jointe au destinataire. Aucune notification indiquant que le message électronique et la pièce jointe ont été bloqués n'est envoyée à l'expéditeur.

AdminMessage

Facultatif

System.String

Ce paramètre spécifie le contenu d’un fichier texte qui remplace les pièces jointes supprimées par l'Agent de filtrage des pièces jointes. Le paramètre AdminMessage ne s’affiche que lorsque l’Agent de filtrage des pièces jointes est configuré pour supprimer une pièce jointe identifiée comme incorrecte.

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.

ExceptionConnectors

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie une liste de connecteurs à exclure du filtrage des pièces jointes. Les filtres des pièces jointes ne sont pas appliqués aux messages électroniques reçus via ces connecteurs. Vous devez utiliser le GUID de connecteur pour spécifier la valeur ExceptionConnectors.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentFilteringConfig

Le paramètre Instance 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.

RejectResponse

Facultatif

System.String

Ce paramètre est nécessaire uniquement lorsque vous définissez le paramètre Action comme Reject. Le paramètre RejectResponse prend une valeur de chaîne. Entrez le corps du message à délivrer dans la notification d'échec de remise adressée aux expéditeurs dont les messages contiennent une pièce jointe bloquée. Ne dépassez pas 240 caractères dans l'argument. Lorsque vous transmettez un argument, vous devez placer le paramètre RejectResponse entre guillemets doubles si la phrase contient des espaces, comme suit : "Message rejected". Le paramètre par défaut est Message rejected due to unacceptable attachments.

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

Exceptions

Exceptions Description

Exemple

Par défaut, l'Agent de filtrage des pièces jointes est configuré pour bloquer les pièces jointes qui correspondent à une entrée de la liste de filtrage des pièces jointes et leurs messages. L'exemple de code suivant modifie l'action que l'Agent de filtrage des pièces jointes applique à une pièce jointe correspondant à une entrée de la liste de filtrage des pièces jointes de façon à ce que le message électronique et la pièce jointe ne soient pas remis au destinataire et à ce qu'une notification d'échec de remise soit envoyée à l'expéditeur. L'exemple de code spécifie également un connecteur qui n'exécutera pas l'Agent de filtrage des pièces jointes.

Set-AttachmentFilterListConfig -Action Reject -ExceptionConnectors fc4d8ce2-2c0d-4116-b036-143b19a81384