Set-RecipientFilterConfig

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-RecipientFilterConfig permet d'activer et de configurer l'agent de filtrage de destinataires sur un ordinateur sur lequel le rôle serveur de transport Edge ou Hub Transport est installé.

Syntaxe

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-RecipientFilterConfig, 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-RecipientFilterConfig 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
BlockedRecipients	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Une entrée valide pour le paramètre BlockedRecipients Enabled est une ou plusieurs adresses SMTP. Vous pouvez entrer jusqu'à 800 adresses SMTP individuelles pour le paramètre BlockedRecipients.
BlockListEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre BlockListEnabled Enabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre BlockListEnabled a la valeur `$true`, l'agent de filtrage des destinataires bloque les messages envoyés aux destinataires répertoriés dans le paramètre BlockedRecipients.
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 a la valeur `$true`, l'agent de filtrage des destinataires est activé sur l'ordinateur sur lequel la cmdlet `Set-RecipientFilterConfig` 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 des destinataires pour traitement.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig	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 domaines d'expéditeur authentifié appartenant à des domaines faisant autorité au sein de votre entreprise sont transmis via l'agent de filtrage des destinataires pour traitement.
RecipientValidationEnabled	Facultatif	System.Boolean	Une entrée valide pour le paramètre RecipientValidationEnabled Enabled est `$true` ou `$false`. Le paramètre par défaut est `$false`. Lorsque le paramètre RecipientValidationEnabled a la valeur `$true`, l'agent de filtrage des destinataires bloque les messages contenant des destinataires inexistants au sein de votre organisation.
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 illustre les commandes Set‑RecipientFilterConfig.

Le premier exemple de code montre comment modifier la configuration du filtre des destinataires pour activer la validation de destinataire.

Le second exemple de code montre comment activer la liste rouge des destinataires et y ajouter des destinataires.

Le paramètre BlockedRecipients prend plusieurs valeurs. Lorsque vous transmettez une valeur au paramètre BlockedRecipients, la valeur existante est remplacée par la nouvelle valeur. Pour plus d'informations sur l'ajout ou la suppression des valeurs des propriétés à valeurs multiples, consultez la rubrique Modification de propriétés à valeurs multiples.

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com