Add-AttachmentFilterEntry
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2009-04-28
La cmdlet Add-AttachmentFilterEntry permet d'ajouter une entrée à la liste de filtrage des pièces jointes sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé.
Syntaxe
add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-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 Microsoft Exchange Server 2007 en fonction du type de contenu et du nom de fichier. La configuration de l'agent de filtrage des pièces jointes détermine la manière dont les pièces jointes sont traitées.
Pour plus d'informations sur la configuration de l'agent de filtrage des pièces jointes, consultez la rubrique Set-AttachmentFilterListConfig.
La cmdlet Add‑AttachmentFilterEntry permet de filtrer les pièces jointes en fonction des types de contenus MIME et du nom de fichier. La liste suivante décrit chaque type de pièce jointe :
Types de contenus MIME Les types de contenus MIME indiquent la nature de la pièce jointe, par exemple, s'il s'agit d'une image JPEG, d'un fichier exécutable, d'un fichier Microsoft Office Excel 2003 ou d'un autre type de fichier. Les pièces jointes sont codées dans les messages électroniques comme du texte ASCII. Les serveurs et clients de messagerie utilisent les informations relatives au type de contenu MIME pour décoder les informations en texte ASCII contenues dans un message électronique et les convertir en un fichier binaire utilisable dont le format est familier pour l'utilisateur. Les types de contenus sont exprimés comme
type/subtype. Par exemple, le type de contenu image JPEG est exprimé commeimage/jpeg.Pour plus d'informations sur les types de contenus MIME, consultez le RFC (Request for Comments) 1341.
Notes
UNRESOLVED_TOKEN_VAL(exNote3rdPartyURL)
Noms de fichier Il y a deux façons de spécifier les noms de fichier en pièce jointe dans les listes de filtrage des pièces jointes. Vous pouvez spécifier un nom de fichier exact, tel que BadFilename.exe, ou spécifier un fichier ayant un type d'extension spécifique en remplaçant le nom de fichier à gauche du point par un caractère générique. Un exemple d'utilisation d'un caractère générique dans un nom de fichier est *.exe.
Pour exécuter la cmdlet Add-AttachmentFilterEntry 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 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Obligatoire |
System.String |
Ce paramètre spécifie le type de contenu MIME ou le nom de fichier de la pièce jointe. Si la valeur de Type est |
Type |
Obligatoire |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType |
Ce paramètre spécifie le type de pièce jointe que cette entrée de filtrage des pièces jointes bloque. Les valeurs valides sont
|
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. |
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
Vous pouvez ajouter des entrées à la liste de filtrage des pièces jointes afin de protéger les utilisateurs contre des pièces jointes malveillantes ou inadéquates. Les exemples de code suivants montrent comment ajouter une entrée à la liste de filtrage des pièces jointes.
Le premier exemple de code ajoute une entrée de filtrage des pièces jointes basée sur un nom de fichier. Ce filtre des pièces jointes s'applique à toutes les pièces jointes dont l'extension est .txt.
Le second exemple de code ajoute une entrée de filtrage des pièces jointes basée le type de contenu MIME image/jpeg qui est un fichier binaire d'image JPEG. Ce filtre des pièces jointes s'applique à toutes les pièces jointes ayant un type de contenu MIME image/jpeg.
add-attachmentfilterentry -name *.txt -type FileName
add-attachmentfilterentry -name image/jpeg -type ContentType