New-TransportRule
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-08-13
La cmdlet New-TransportRule permet de créer une règle de transport utilisée par l'agent de règles de transport lorsqu'il traite des messages électroniques qui transitent via un ordinateur sur lequel le rôle de serveur de transport Hub ou de transport Edge Microsoft Exchange Server 2007 est installé.
Syntaxe
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet New-TransportRule permet de créer une règle de transport utilisée par l'agent de règles de transport lorsqu'il traite des messages électroniques qui transitent via un serveur de transport Hub ou de transport Edge dans une organisation Exchange 2007.
Les conditions et exceptions doivent utiliser un prédicat de règle pris en charge. Chaque prédicat est constitué du prédicat lui-même et de la valeur que vous voulez tester.
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 prise en charge. Chaque action est constituée de l'action elle-même et des valeurs que l'action utilise pour exécuter sa tâche.
Pour obtenir la liste des actions de règle de transport prises en charge, consultez la rubrique Actions de règle de transport.
Pour plus d'informations sur la procédure de création d'une règle de transport, consultez la rubrique Procédure de création 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 New-TransportRule, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour exécuter la cmdlet New-TransportRule sur un ordinateur sur lequel le rôle de 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 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Actions |
Obligatoire |
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. |
Name |
Obligatoire |
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. |
Comments |
Facultatif |
System.String |
Ce paramètre permet d'ajouter des commentaires informatifs à la règle, tels que l'objet de la règle ou son évolution dans le temps. Le commentaire ne peut pas comporter plus de 1024 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 du 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 qui exécutent le rôle de serveur de transport Edge. Le rôle de serveur de transport Edge écrit uniquement sur l'instance Active Directory en mode application (ADAM) locale. |
Enabled |
Facultatif |
System.Boolean |
Ce paramètre permet d'indiquer si la règle de transport doit être activée ou désactivée au moment de sa création. La valeur par défaut est |
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. |
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. |
TemplateInstance |
Facultatif |
System.Management.Automation.PSObject |
Lorsqu'un objet existant est fourni pour ce paramètre, la commande utilise la configuration de l'objet pour créer une copie identique de l'objet sur un serveur local ou cible. Pour plus d'informations, consultez la rubrique Modèles. |
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 suivant montre comment créer une règle de transport sur un serveur de transport Hub.
Cette règle applique les conditions suivantes :
- between distribution list and distribution list La valeur de propriété du premier prédicat pour cette condition est le groupe de distribution « Sales Group ». La valeur de la seconde propriété de prédicat pour cette condition est le groupe de distribution « Brokerage Group ».
Les exceptions suivantes s'appliquent :
with text patterns in the subject La valeur de cette exception est « Press Release » ou « Corporate Communication ».
from people Les valeurs pour cette exception sont les utilisateurs Ted Bremer et Pilar Ackerman.
Les actions suivantes sont appliquées à tout message correspondant aux conditions décrites ici mais ne correspondent pas aux exceptions « with text patterns in the subject » ou « from people » :
send bounce message to sender La valeur de cette action est « E-Mail messages sent between the Sales department and the Brokerage department are prohibited ».
log event with message La valeur pour cette action est « A prohibited e-mail message has been rejected ».
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)