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)