Partager via


Set-TransportRule

 

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

Dernière rubrique modifiée : 2007-07-27

La cmdlet Set-TransportRule permet de modifier une règle de transport existante utilisée par l'agent de règles de transport lorsqu'il traite des messages électroniques qui transitent par un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.

Syntaxe

Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-TransportRule permet de modifier une règle de transport existante utilisée par l'agent de règles de transport lorsqu'il traite des messages électroniques qui transitent par un serveur de transport Hub ou Edge.

Les conditions et exceptions doivent utiliser un prédicat de règle de transport pris en charge. Chaque prédicat est constitué d'au moins une condition et des valeurs testées par la condition.

Pour obtenir la liste des prédicats de règle de transport pris en charge, consultez la rubrique Prédicats de règle de transport.

Chaque action doit utiliser une action de règle de transport prise en charge. Chaque action est constituée d'au moins une action et des valeurs que l'action utilise pour exécuter sa tâche.

Pour obtenir la liste des actions de règle prises en charge, consultez la rubrique Actions de règle de transport.

Pour plus d'informations sur la procédure de modification d'une règle de transport existante, consultez la rubrique Procédure de modification d'une règle de transport.

Pour plus d'informations sur l'agent de règles de transport, consultez la rubrique Vue d'ensemble des règles de transport.

Pour exécuter la cmdlet Set-TransportRule, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Ce paramètre permet de spécifier le GUID de la règle de transport ou le nom de la règle configuré par l'administrateur lors de la création de la règle.

Actions

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[]

Ce paramètre permet de spécifier les actions appliquées par la règle de transport au message électronique si toutes les conditions sont remplies et qu'aucune exception n'est rencontrée. Vous devez spécifier au moins une action pour chaque règle.

Comments

Facultatif

System.String

Ce paramètre permet d'ajouter des commentaires informatifs à la règle de transport, tels que l'objet de la règle ou son évolution dans le temps. Le commentaire ne peut pas comporter plus de 512 caractères.

Conditions

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[]

Ce paramètre permet de spécifier les conditions appliquées par la règle de transport aux messages électroniques soumis à l'agent de règles de transport. Si vous ne configurez pas de condition sur une règle, celle-ci sera appliquée à tous les messages si aucune exception n'est rencontrée.

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 extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rôle serveur de transport Edge écrit uniquement sur l'instance Active Directory Application Mode (ADAM) locale.

Exceptions

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[]

Ce paramètre permet de spécifier les exceptions appliquées par la règle de transport au message électronique. Si un message correspond à une exception, aucune des actions spécifiées sur cette règle n'est appliquée au message.

Instance

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule

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

Name

Facultatif

System.String

Ce paramètre permet de spécifier le nom complet de la règle de transport à créer. Le nom ne peut pas comporter plus de 64 caractères.

Priority

Facultatif

System.Int32

Ce paramètre permet de spécifier l'ordre dans lequel les règles de transport sont appliquées. Si vous modifiez la priorité d'une règle, la position de la règle dans la liste de règles est modifiée afin de correspondre à la priorité que vous avez spécifiée, et l'agent de règles de transport incrémente toutes les règles d'une valeur de priorité plus élevée. Les règles avec une valeur de priorité plus faible sont traitées en premier. La valeur de ce paramètre doit être supérieure ou égale à 0.

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

L'exemple complet suivant montre la manière de modifier une règle de transport existante sur un serveur de transport Hub. Il montre comment modifier les conditions d'une règle de transport sans affecter les exceptions ou actions de la règle.

Cette règle sera modifiée pour appliquer la condition suivante :

  • from member of distribution list   La valeur de cette condition est le groupe de distribution « Sales Group ».
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)