First, you must preserve the existing actions. Assign each existing action in the action array to its own variable. Use the following command syntax to assign the action array to a variable:

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

To assign the actions of a transport rule to a variable and view how many actions are in the array

Then assign each action in the array to its own variable. The actions are in array elements, which are numbered 0 through $ActionArray.Length - 1. Use the following syntax to assign each action array element to its own variable:

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

To assign each action array element to its own variable

Then create the new action or actions. You cannot use the actions that are already applied to the existing transport rule. Use the following syntax to assign a new action to a variable:

	Copy Code
$NewAction = Get-TransportRuleAction <Action Name>

For a list of transport rule actions, see Transport Rule Actions.

To assign a new action to a new variable

After you assign the new action to a new variable, assign a value to the action. Use the following command to assign a value to the new action:

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

For a list of transport rule action properties and the expected formatting of their values, see Transport Rule Actions.

To assign values to a new action

After you create all the new actions, apply the actions to the existing transport rule. Use the following command syntax to modify the transport rule:

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

Note:
You must order the existing and new actions according to their Rank when you specify the actions in the Set-TransportRule command. Use the Get-TransportRuleAction command to view the rank of each action.

To modify the existing transport rule

To remove an action from a transport rule, follow these steps from the section earlier in this topic:

1. Assign the actions of a transport rule to a variable and view how many actions are in the array.
   
   
2. Assign each action array element to its own variable, except the action that you want to remove.
   
   
3. Modify the existing transport rule.
   
   

To remove an action from a transport rule

First, assign the actions of the existing transport rule to a variable and view the array. Use the following command syntax:

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

To assign the actions of a transport rule to a variable and view how many actions are in the array

Determine which action you want to modify and note its array element number. The first action in the array is at array element 0. If the action that you want to modify is the third action in the list, its array element number is 2. You must then determine the action property or properties. The action properties are always listed immediately before the line starting with Name.

After you determine the array element number, assign the new value to that action by using the following command syntax:

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

For a list of transport rule action properties and the expected formatting of their values, see Transport Rule Actions.

To assign a value to the SetScl action at array element 2

To modify the existing transport rule

• Run the following command:

  	Copy Code
  Set-TransportRule "Test Rule" -Action $ActionArray

Note:
You don't have to insert the $ActionArray variable in an array because the $ActionArray variable is already an array.

First, you must assign the actions of the existing transport rule to a variable and view the array. Use the following command syntax:

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

To assign the actions of a transport rule to a variable and view how many actions are in the array

Determine which action you want to modify and note its array element number. The first action in the array is at array element 0. If the action that you want to modify is the third action in the list, its array element number is 2. You must then determine the action property or properties of the action. The action's action properties are always listed immediately before the line starting with Name, as in the following example:

	Copy Code
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>

In this example, the first action, at array element 0, has the action property Addresses. The second action, at array element 1, has the action properties RejectReason and EnhancedStatusCode.

To add new values to an existing action, use the following command syntax:

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

For a list of transport rule action properties and the expected formatting of their values, see Transport Rule Actions.

To add values to an existing action at array element 0 of the example

To modify the existing transport rule

• Run the following command:

  	Copy Code
  Set-TransportRule "Test Rule" -Action $ActionArray

Note:
You don't have to insert the $ActionArray variable in an array because $ActionArray variable is already an array.

To remove values from an existing action, you must note the existing values and then re-enter the existing values into the action, omitting the values that you no longer want. When you perform the following procedure, the existing values are replaced with the values that you specify.

Note:
The following procedure works well for actions that have only a few values configured. However, for actions that have dozens, or hundreds, of values configured, this procedure is not feasible. We recommend that you use a ForEach loop when it is impractical to manually reassign values to an action. For more information, see Using the Exchange Management Shell.

First, you must assign the actions of the existing transport rule to a variable and view the array. Use the following command syntax:

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

To assign the actions of a transport rule to a variable and view how many actions are in the array

Then view the values of the action that you want to modify and replace the values of that action with the values that you want to keep. For more information about how to determine the element number and action properties of an action array, see "Adding Values to an Existing Multiple-Value Action" earlier in this topic. Use the following command syntax:

	Copy Code
$ActionArray[<Array Element Number>]

Then replace the existing values of the action that you want to modify with the values that you want to keep. Use the following command syntax:

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

For a list of transport rule action properties and the expected formatting of their values, see Transport Rule Predicates.

To remove values from an existing action at array element 0 of the earlier example

To modify the existing transport rule