Procédure de modification des conditions et exceptions d'une règle de transport dans Exchange Management Shell

  • Article

 

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

Dernière rubrique modifiée : 2007-03-20

Cette rubrique décrit l'utilisation de l'environnement de ligne de commande Exchange Management Shell pour modifier les conditions et les exceptions d'une règle de transport existante configurée sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge Microsoft Exchange Server 2007 est installé.

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

Avant de commencer

Avant d'exécuter les procédures suivantes, consultez la rubrique Procédure de modification d'une règle de transport, qui fournit des informations importantes nécessaires pour modifier les conditions et les exceptions d'une règle de transport.

Pour exécuter ces procédures, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour exécuter les procédures suivantes 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 Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Pour exécuter ces procédures, vous devez connaître les concepts suivants :

Pour plus d'informations sur l'environnement de ligne de commande Exchange Management Shell, consultez la rubrique Utilisation d'Exchange Management Shell.

Modification des conditions ou exceptions d'une règle de transport

Les procédures utilisées pour modifier les conditions et exceptions des règles de transport présentent de nombreuses similitudes car les conditions et les exceptions utilisent les mêmes prédicats sous-jacents de règle de transport. Les procédures décrites dans cette rubrique utilisent les conditions de règle de transport comme exemple, mais vous pouvez également appliquer ces procédures aux exceptions de règle de transport. Pour utiliser les règles suivantes pour modifier des exceptions de règle de transport, remplacez Conditions par Exceptions. Prenons l'exemple suivant :

  • Pour accéder aux conditions d'une règle de transport, utilisez la commande suivante :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  • Pour accéder aux exceptions d'une règle de transport, utilisez la commande suivante :

    $ExceptionArray = (Get-TransportRule "Test Rule").Exceptions

Ajout de conditions à une règle de transport

Premièrement, vous devez conserver les conditions existantes. Attribuez chaque condition existante du tableau de conditions à sa variable. Utilisez la syntaxe de commande suivante pour attribuer le tableau de conditions à une variable :

$ConditionArray = (Get-TransportRule "<rule name>").Conditions

Attribution des conditions d'une règle de transport à une variable et affichage du nombre de conditions dans le tableau

  1. Exécutez la commande suivante pour attribuer le tableau de conditions à une variable :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  2. Exécutez la commande suivante pour afficher le nombre de conditions dans le tableau :

    $ConditionArray.Length

Puis attribuez chaque condition dans le tableau à sa variable. Les conditions sont dans des éléments de tableau, qui sont numérotés de 0 à $Condition.Length - 1. Utilisez la syntaxe suivante pour attribuer chaque élément de tableau de conditions à sa variable :

$ExistingCondition<Array Element Number> = $ConditionArray[<Array Element Number>]

Attribution de chaque élément de tableau de conditions à sa variable

  • Exécutez les commandes suivantes :

    $ExistingCondition0 = $ConditionArray[0]
$ExistingCondition1 = $ConditionArray[1]

Créez ensuite une ou plusieurs conditions. Vous ne pouvez pas utiliser les conditions déjà appliquées à la règle de transport existante. Utilisez la syntaxe suivante pour attribuer une nouvelle condition à une variable :

$NewCondition = Get-TransportRulePredicate <Predicate Name>

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

Attribution d'une nouvelle condition à une nouvelle variable

  • Exécutez la commande suivante :

    $NewCondition = Get-TransportRulePredicate SubjectContains

Après avoir attribué la nouvelle condition à une nouvelle variable, attribuez des valeurs à la condition. La commande suivante permet d'attribuer des valeurs à la nouvelle condition :

$NewCondition.<PredicateProperty> = <Single Value or Array of Values>

Pour obtenir la liste des propriétés de prédicat de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Prédicats de règle de transport.

Attribution de valeurs à une nouvelle condition

  • Exécutez la commande suivante :

    $NewCondition.Words = @("Test Subject 1", "Test Subject 2")

Après avoir créé les nouvelles conditions, appliquez toutes les conditions à la règle de transport existante. Utilisez la syntaxe de commande suivante pour modifier la règle de transport :

Set-TransportRule <Transport Rule Name> -Condition @(<Conditions>)

Notes

Vous devez classer les conditions existantes et nouvelles en fonction de leur Rank lorsque vous les spécifiez dans la commande Set-TransportRule. La commande Get-TransportRulePredicate permet d'afficher le rang de chaque condition ou exception.

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Condition @($ExistingCondition0, $ExistingCondition1, $NewCondition)

Suppression de conditions d'une règle de transport

Pour supprimer une condition d'une règle de transport, procédez comme suit à partir de la section ci-avant dans cette rubrique :

  1. Attribuez les conditions d'une règle de transport à une variable et affichez le nombre de conditions dans le tableau.

  2. Attribuez chaque élément de tableau de conditions à sa variable, sauf la condition que vous voulez supprimer.

  3. Modifiez la règle de transport existante.

Suppression d'une condition d'une règle de transport

  1. Exécutez la commande suivante pour attribuer le tableau de conditions à une variable :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  2. Exécutez la commande suivante pour afficher le nombre de conditions dans le tableau :

    $ConditionArray.Length

  3. Exécutez la commande suivante pour afficher les conditions dans la variable $ConditionArray et noter le numéro d'élément de tableau de la condition que vous voulez supprimer :

    $ConditionArray

  4. Exécutez la commande suivante pour attribuer les conditions que vous voulez conserver à des variables, en omettant les éléments de tableau de conditions que vous ne voulez pas conserver :

    $ExistingCondition1 = $Condition[1]
...

  5. Exécutez la commande suivante pour modifier la règle de transport, en attribuant uniquement les variables associées aux conditions que vous voulez conserver :

    Set-TransportRule "Test Rule" -Condition @($ExistingCondition1)

Modification des valeurs d'une condition existante d'une règle de transport

Les procédures de modification d'une condition dépendent de l'acceptation par la condition d'une valeur unique ou de plusieurs valeurs. Suivez la procédure s'appliquant au type de la condition que vous voulez modifier.

Pour déterminer le type de la condition que vous voulez modifier, consultez la rubrique Prédicats de règle de transport.

Modification d'une condition existante à valeur unique

Premièrement, attribuez les conditions de la règle de transport existante à une variable et affichez le tableau. Utilisez la syntaxe de commande suivante :

$ConditionArray = (Get-TransportRule "Test Rule").Conditions

Attribution des conditions d'une règle de transport à une variable et affichage du nombre de conditions dans le tableau

  1. Exécutez la commande suivante pour attribuer le tableau de conditions à une variable :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  2. Exécutez la commande suivante pour afficher les conditions dans le tableau :

    $ConditionArray

Identifiez la condition que vous voulez modifier et notez son numéro d'élément de tableau. Consultez la section « Ajout de valeurs à une condition existante à valeurs multiples » ci-après dans cette rubrique pour rechercher le numéro d'élément de tableau correct.

Après avoir identifié le numéro d'élément de tableau, attribuez la nouvelle valeur à cette condition en utilisant la syntaxe de commande suivante :

$ConditionArray[<array element number>].<Predicate Property> = <Single Value>

Attribution d'une valeur à la condition WithImportance au numéro d'élément de tableau 2

  • Exécutez la commande suivante :

    $ConditionArray[2].Importance = "High"

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Condition $ConditionArray

Notes

Il n'est pas utile d'insérer la variable $ConditionArray dans un tableau car la variable $ConditionArray est déjà dans un tableau.

Ajout de valeurs à une condition existante à valeurs multiples

Premièrement, vous devez attribuer les conditions de la règle de transport existante à une variable et afficher le tableau. Utilisez la syntaxe de commande suivante :

$ConditionArray = (Get-TransportRule "Test Rule").Conditions

Attribution des conditions d'une règle de transport à une variable et affichage du nombre de conditions dans le tableau

  1. Exécutez la commande suivante pour attribuer le tableau de conditions à une variable :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  2. Exécutez la commande suivante pour afficher les conditions dans le tableau :

    $ConditionArray

Identifiez la condition que vous voulez modifier et notez son numéro d'élément de tableau. La première condition dans le tableau est à l'élément de tableau 0. Si la condition que vous voulez modifier est la troisième condition dans la liste, son numéro d'élément de tableau est 2. Vous devez ensuite déterminer la propriété ou les propriétés de prédicat de la condition. Les propriétés de prédicat de la condition sont toujours répertoriées juste avant la ligne commençant par LinkedDisplayTextException, comme dans l'exemple suivant :

Addresses                  : {Kim Akers}
LinkedDisplayTextException : except if from <a id="Addresses">people</a>
Name                       : From
Rank                       : 0
LinkedDisplayText          : from <a id="Addresses">people</a>

Words                      : {Corporate Communication, Message from VP, Sales Quotas}
LinkedDisplayTextException : except if with <a id="Words">specific words</a> in the subject
Name                       : SubjectContains
Rank                       : 15
LinkedDisplayText          : with <a id="Words">specific words</a> in the subject

Dans cet exemple, la première condition, à l'élément de tableau 0, a la propriété de prédicat Addresses. La deuxième condition, à l'élément de tableau 1, a la propriété de prédicat Words.

Pour ajouter de nouvelles valeurs à une condition existante, utilisez la syntaxe de commande suivante :

$ConditionArray[<Array Element Number>].<Predicate Property> += <Array of Values>

Pour obtenir la liste des propriétés de prédicat de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Prédicats de règle de transport.

Ajout de valeurs à une condition existante à l'élément de tableau 1 de l'exemple

  • Exécutez la commande suivante :

    $ConditionArray[1].Words += @("Industry Projections", "Sales Forecast")

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Condition $ConditionArray

Notes

Il n'est pas utile d'insérer la variable $ConditionArray dans un tableau car la variable $ConditionArray est déjà dans un tableau.

Suppression de valeurs d'une condition existante à valeurs multiples

Pour supprimer des valeurs d'une condition existante, vous devez noter les valeurs existantes puis les ré-entrez dans la condition, en omettant les valeurs que vous ne voulez pas conserver. Lorsque vous exécutez la procédure suivante, les valeurs existantes sont remplacées par les valeurs que vous spécifiez.

noteRemarque :
La procédure suivante fonctionne parfaitement pour les conditions qui n'ont que quelques valeurs configurées. Toutefois, pour les conditions ayant des dizaines ou des centaines de valeurs configurées, cette procédure n'est pas viable. Il est conseillé d'utiliser une boucle foreach lorsque la réattribution manuelle de valeurs à une condition serait excessivement longue.
Pour plus d'informations, consultez la rubrique Utilisation d'Exchange Management Shell.

Premièrement, vous devez attribuer les conditions de la règle de transport existante à une variable et afficher le tableau. Utilisez la syntaxe de commande suivante :

$ConditionArray = (Get-TransportRule "Test Rule").Conditions

Attribution des conditions d'une règle de transport à une variable et affichage du nombre de conditions dans le tableau

  1. Exécutez la commande suivante pour attribuer le tableau de conditions à une variable :

    $ConditionArray = (Get-TransportRule "Test Rule").Conditions

  2. Exécutez la commande suivante pour afficher les conditions dans le tableau :

    $ConditionArray

Puis affichez les valeurs de la condition que vous voulez modifier et remplacez les valeurs de cette condition avec les valeurs que vous voulez conserver. Pour plus d'informations sur l'identification d'un numéro d'élément et des propriétés de prédicat d'un tableau de conditions, consultez la section « Ajout de valeurs à une condition existante à valeurs multiples » ci-avant dans cette rubrique. Utilisez la syntaxe de commande suivante :

$ConditionArray[<Array Element Number>]

Puis remplacez les valeurs existantes de la condition que vous voulez modifier avec les valeurs que vous voulez conserver. Utilisez la syntaxe de commande suivante :

$ConditionArray[<Array Element Number>].<Predicate Property> = <Array of Values>

Pour obtenir la liste des propriétés de prédicat de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Prédicats de règle de transport.

Suppression de valeurs d'une condition existante à l'élément de tableau 1 de l'exemple précédent

  1. Exécutez la commande suivante pour afficher les valeurs actuelles configurées sur la condition :

    $ConditionArray[1]

  2. Exécutez la commande suivante pour remplacer les valeurs actuelles avec les valeurs souhaitées :

    $ConditionArray[1].Words = @("Corporate Communication", "Sales Quotas")

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Condition $ConditionArray

Notes

Il n'est pas utile d'insérer la variable $ConditionArray dans un tableau car la variable $ConditionArray est déjà dans un tableau.

Pour plus d'informations

Pour obtenir des informations détaillées sur la syntaxe et les paramètres de chaque commande, consultez les rubriques suivantes :

Pour plus d'informations sur les règles de transport, consultez les rubriques suivantes :