Procédure de modification des actions 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-08-27

Cette rubrique décrit l'utilisation d'Exchange Management Shell pour modifier les actions 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 actions 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 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 Exchange Management Shell, consultez la rubrique Utilisation d'Exchange Management Shell.

Modification des actions d'une règle de transport

Ajout d'actions à une règle de transport

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

$ActionArray = (Get-TransportRule "<rule name>").Actions

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

  1. Exécutez la commande suivante pour attribuer le tableau d'actions à une variable :

    $ActionArray = (Get-TransportRule "Test Rule").Actions

  2. Exécutez la commande suivante pour afficher le nombre d'actions dans le tableau :

    $ActionArray.Length

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

$ExistingAction<Array Element Number> = $ActionArray[<Array Element Number>]

Attribution de chaque élément de tableau d'actions à sa variable

  • Exécutez les commandes suivantes :

    $ExistingAction0 = $ActionArray[0]
$ExistingAction1 = $ActionArray[1]

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

$NewAction = Get-TransportRuleAction <Action Name>

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

Attribution d'une nouvelle action à une nouvelle variable

  • Exécutez la commande suivante :

    $NewAction = Get-TransportRuleAction LogEvent

Après avoir attribué la nouvelle action à une nouvelle variable, attribuez une valeur à l'action. La commande suivante permet d'attribuer une valeur à la nouvelle action :

$NewAction.<ActionProperty> = <Single Value or Array of Values>

Pour obtenir la liste des propriétés d'action de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Actions de règle de transport.

Attribution de valeurs à une nouvelle action

  • Exécutez la commande suivante :

    $NewAction.LogMessage = "Transport Rule triggered"

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

Set-TransportRule <Transport Rule Name> -Action @(<Actions>)

Notes

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

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Action @($ExistingAction0, $ExistingAction1, $NewAction)

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

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

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

  2. Attribuez chaque élément de tableau d'actions à sa variable, sauf l'action que vous voulez supprimer.

  3. Modifiez la règle de transport existante.

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

  1. Exécutez la commande suivante pour attribuer le tableau d'actions à une variable :

    $ActionArray = (Get-TransportRule "Test Rule").Actions

  2. Exécutez la commande suivante pour afficher le nombre d'actions dans le tableau :

    $ActionArray.Length

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

    $ActionArray

  4. Exécutez les commandes suivantes pour attribuer les actions que vous voulez conserver à des variables, en omettant les éléments de tableau des actions que vous ne voulez pas conserver :

    $ExistingAction1 = $Action[1]
...

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

    Set-TransportRule "Test Rule" -Action @($ExistingAction1)

Modification de la valeur d'une action existante d'une règle de transport

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

Notes

Les exemples suivants utilisent les actions de la règle de transport disponibles sur les serveurs de transport Hub.

Pour déterminer le type de l’action que vous voulez modifier, consultez la rubrique Actions de règle de transport.

Modification d'une action existante à valeur unique

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

$ActionArray = (Get-TransportRule "Test Rule").Actions

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

  1. Exécutez la commande suivante pour attribuer le tableau d'actions à une variable :

    $ActionArray = (Get-TransportRule "Test Rule").Actions

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

    $ActionArray

Identifiez l'action que vous voulez modifier et notez son numéro d'élément de tableau. La première action dans le tableau est à l'élément de tableau 0. Si l'action que vous voulez modifier est la troisième action 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 l'action. Les propriétés d'action sont toujours indiquées juste devant la ligne commençant par Name.

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

$ActionArray[<array element number>].<Action Property> = <Single Value>

Pour obtenir la liste des propriétés d'action de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Actions de règle de transport.

Attribution d'une valeur à l'action SetScl au numéro d'élément de tableau 2

  • Exécutez la commande suivante :

    $ActionArray[2].SclValue = "7"

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Action $ActionArray

Notes

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

Ajout de valeurs à une action existante à valeurs multiples

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

$ActionArray = (Get-TransportRule "Test Rule").Actions

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

  1. Exécutez la commande suivante pour attribuer le tableau d'actions à une variable :

    $ActionArray = (Get-TransportRule "Test Rule").Actions

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

    $ActionArray

Identifiez l'action que vous voulez modifier et notez son numéro d'élément de tableau. La première action dans le tableau est à l'élément de tableau 0. Si l'action que vous voulez modifier est la troisième action 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 d’action de l’action. Les propriétés d’action de l’action sont toujours répertoriées juste avant la ligne commençant par Name, comme dans l'exemple suivant :

Addresses         : {Legal Group, Regulatory Compliance}
Name              : RedirectMessage
Rank              : 10
LinkedDisplayText : redirect the message to <a id="Addresses">addresses</a>

RejectReason       : Example Message
EnhancedStatusCode : 5.7.1
Name               : RejectMessage
Rank               : 11
LinkedDisplayText  : send <a id="RejectReason">bounce message</a> to sender with <a id ="EnhancedStatusCode">enhanced status code</a>

Dans cet exemple, la première action, à l'élément de tableau 0, a la propriété d’action Addresses. La deuxième action, à l'élément de tableau 1, a la propriété d’action RejectReason.

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

$ActionArray[<Array Element Number>].<Action Property> += <Array of Values>

Pour obtenir la liste des propriétés d'action de règle de transport et la mise en forme attendue de leurs valeurs, consultez la rubrique Actions de règle de transport.

Ajout de valeurs à une action existante à l'élément de tableau 0 de l'exemple

  • Exécutez la commande suivante :

    $ActionArray[0].Addresses += @((Get-DistributionGroup "Example Group 1"), (Get-DistributionGroup "Example Group 2))

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Action $ActionArray

Notes

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

Suppression de valeurs d'une action à valeurs multiples existante

Pour supprimer des valeurs d'une action existante, vous devez noter les valeurs existantes puis les ré-entrer dans l’action, 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 actions qui n'ont que quelques valeurs configurées. Toutefois, pour les actions 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 action serait excessivement longue.
Pour plus d'informations, consultez la rubrique Utilisation d'Exchange Management Shell.

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

$ActionArray = (Get-TransportRule "Test Rule").Actions

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

  1. Exécutez la commande suivante pour attribuer le tableau d'actions à une variable :

    $ActionArray = (Get-TransportRule "Test Rule").Actions

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

    $ActionArray

Puis affichez les valeurs de l’action que vous voulez modifier et remplacez les valeurs de cette action par 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 d’action d'un tableau d’actions, consultez la section « Ajout de valeurs à une action existante à valeurs multiples » ci-avant dans cette rubrique. Utilisez la syntaxe de commande suivante :

$ActionArray[<Array Element Number>]

Puis remplacez les valeurs existantes de l'action que vous voulez modifier par les valeurs que vous voulez conserver. Utilisez la syntaxe de commande suivante :

$ActionArray[<Array Element Number>].<Action Property> = <Array of Values>

Pour obtenir la liste des propriétés d'action 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 action existante à l'élément de tableau 0 de l'exemple précédent

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

    $ActionArray[0]

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

    $ActionArray[0].Addresses = @((Get-Mailbox "Kim Akers"),(Get-Mailbox "Frank Lee"))

Modification de la règle de transport existante

  • Exécutez la commande suivante :

    Set-TransportRule "Test Rule" -Action $ActionArray

    Notes

    Il n'est pas utile d'insérer la variable $ActionArray dans un tableau car la variable $ActionArray 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 :