How to Modify a Journal Rule

  • Article

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007, Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

This topic explains how to use the Exchange Management Console or the Exchange Management Shell to modify an existing journal rule on a computer that has the Microsoft Exchange Server 2007 Hub Transport server role installed.

For more information about journaling, see Overview of Journaling.

Before You Begin

To perform the following procedures, the account you use must be delegated the following:

  • Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Important   These procedures describe how to configure premium journaling. To use premium journaling, you must have the Exchange Enterprise Client Access License (CAL). For more information, see Overview of Journaling.

Important

There are important security and resource considerations when you configure the journaling mailbox that receives journal reports. For more information, see "Journaling Mailboxes" and "Protecting Journal Reports Sent Inside an Exchange Server 2007 Organization" in Overview of Journaling.

Important

The Journaling agent must be enabled for journal rules to be applied to e-mail messages that enter and leave the Hub Transport server. If individual journal rules are enabled, but the Journaling agent is disabled, Exchange Server 2007 does not apply the journal rules. To determine whether the Journaling agent is enabled on a Hub Transport server, run the following command:
Get-TransportAgent
For more information about the Get-TransportAgent command, see Get-TransportAgent.
To enable the Journaling agent if it is not enabled, run the following command:
Enable-TransportAgent -Identity "Journaling agent"
For more information about the Enable-TransportAgent command, see Enable-TransportAgent.

Note

When you modify journal rules on a Hub Transport server, the modified journal rule is replicated across the Exchange 2007 organization to all the Hub Transport servers.

Using the Exchange Management Console to Modify a Journal Rule

In the Exchange Management Console, you can modify journal rules by following this procedure.

To use the Exchange Management Console to modify an existing journal rule

  1. Open the Exchange Management Console on the Hub Transport server.

  2. In the console tree, click Organization Configuration, and then click Hub Transport.

  3. In the result pane, click the Journaling tab.

  4. Right-click the journal rule that you want to modify, and then click Properties.

  5. Modify the values of the fields that you want to change. You can modify the following fields:

    • Rule name   This field specifies the name of the journal rule.

    • Send Journal reports to e-mail address   This field specifies the journaling mailbox or the third-party e-mail recipient that will receive the journal reports.

    • Scope   This field specifies whether the journal rule is applied to internal recipients and senders only, to external recipients and senders only, or to both.

    • Journal messages for recipient   This field specifies the mailbox, contact, or distribution group that you want to journal. All messages sent to or from this recipient are journaled.

  6. Click OK when you are finished to save your changes.

Using the Exchange Management Shell to Modify a Journal Rule

To modify an existing journal rule, you must specify the identity of the journal rule and then at least one parameter that you want to modify. Use the following command syntax:

Set-JournalRule <Identity> -Name <Journal Rule Name> -Recipient <Recipient SMTP Address to be Journaled> -JournalEmailAddress <Journal Mailbox Recipient Object> -Scope <Internal | External | Global>

The JournalEmailAddress parameter specifies the secured journaling mailbox or the third-party e-mail recipient that will receive the journal reports. The Recipient parameter specifies SMTP address of the mailbox, contact, or distribution group that you want to journal. All messages sent to or from this recipient are journaled.

The Scope parameter specifies the e-mail messages to which the rule is applied. Valid values for this parameter are Global, Internal, and External. The following scopes are available:

  • Global   Global rules process all e-mail messages that pass through a Hub Transport server. This includes messages that may have already been processed by Internal rules and External rules.

  • Internal   Internal rules process e-mail messages that are sent and received by recipients in the Exchange 2007 organization.

  • External   External rules process e-mail messages that are sent to recipients or from senders outside the Exchange 2007 organization.

To modify an existing journal rule

  • Run the following command to change the name of a journal rule:

    Set-JournalRule "Old Journal Name" -Name "New Journal Name"

  • Run the following command to change the journaling mailbox:

    Set-JournalRule "Contoso Journal Rule" -JournalEmailAddress "Journal Mailbox"

  • Run the following command to change the e-mail recipient to be journaled and the scope of the journal rule:

    Set-JournalRule "Contoso Journal Rule" -Recipient discovery@contoso.com -Scope Global

For detailed syntax and parameter information, see Set-JournalRule.