How to Modify a Journal Rule
Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-02-08
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.
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.
|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.|
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:|
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:
For more information about the Enable-TransportAgent command, see Enable-TransportAgent.
|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.|
In the Exchange Management Console, you can modify journal rules by following this procedure.
Open the Exchange Management Console on the Hub Transport server.
In the console tree, click Organization Configuration, and then click Hub Transport.
In the result pane, click the Journaling tab.
Right-click the journal rule that you want to modify, and then click Properties.
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.
Click OK when you are finished to save your changes.
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
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.
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 firstname.lastname@example.org -Scope Global
For detailed syntax and parameter information, see Set-JournalRule.