Set-JournalRule (RTM)

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

Use the Set-JournalRule cmdlet to modify an existing journal rule on a computer that has the Microsoft Exchange Server 2007 Hub Transport server role installed.

Syntax

set-journalrule -Identity <RuleIdParameter> [-DomainController <Fqdn>] [-JournalEmailAddress <RecipientIdParameter>] [-Name <String>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>]

set-journalrule [-DomainController <Fqdn>] [-Instance <JournalRuleObject>] [-JournalEmailAddress <RecipientIdParameter>] [-Name <String>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>]

Detailed Description

The Set-JournalRule cmdlet modifies an existing journal rule that is used with the Journaling agent.

To run the Set-JournalRule cmdlet, 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.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Use this parameter to specify the GUID or name of the rule to be modified.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the command.

Instance

Optional

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleObject

Use this parameter to you to pass an entire object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command.

JournalEmailAddress

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Use this parameter to specify a recipient object to which journal reports are sent. Journal reports can be sent to a mailbox, a contact, a mail user, or a distribution group. However, a Public Folder should not be used as a JournalEmailAddress and is not a supported option.

Name

Optional

System.String

Use this parameter to modify the name of the journal rule. The name of the rule can be up to 64 characters long.

Recipient

Optional

System.Nullable

Use this parameter to specify the SMTP address of a mailbox, contact, or distribution group to journal. If you specify a distribution group, all recipients in that distribution group are journaled. All messages sent to or from a recipient are journaled.

Scope

Optional

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope

Use this parameter to specify the e-mail messages to which the journal rule is applied. Valid values for this parameter are as follows:

  • Global   Global rules process all e-mail messages that pass through a Hub Transport server. This includes e-mail messages that were already processed by the external and internal rules. The default value is Global.

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

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

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

 

Example

The following example shows how to modify the journal e-mail address to which journal reports are sent by an existing journal rule.

Set-JournalRule "Brokerage Communications" -JournalEmailAddress "Archive Mailbox"