Set-RecipientFilterConfig (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-08-27
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>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>]
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 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 |
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 |
ExternalMailEnabled |
Facultatif |
System.Boolean |
Une entrée valide pour le paramètre ExternalMailEnabled est |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig |
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. |
InternalMailEnabled |
Facultatif |
System.Boolean |
Une entrée valide pour le paramètre InternalMailEnabled est |
RecipientValidationEnabled |
Facultatif |
System.Boolean |
Une entrée valide pour le paramètre RecipientValidationEnabled Enabled est |
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 d'interdiction d'IP et ajouter des destinataires à la liste de destinataires bloqués.
La propriété BlockedRecipients prend plusieurs valeurs ; lorsque vous transmettez une valeur à la propriété BlockedRecipients, la valeur existante est remplacée par la nouvelle valeur. Pour obtenir des informations de procédure expliquant comment ajouter des valeurs à une propriété existante à 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