Share via


Export and Import Exchange 2007 Journal Rules

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Journal rules allow you to granularly journal messages sent to and from specific recipients. Journal reports containing message metadata fields such as sender, recipients, message ID, and subject are delivered to the journaling mailbox specified in the rule, along with a copy of the original message as an attachment. To learn more about journaling, see Understanding Journaling.

Microsoft Exchange Server 2010 and Exchange Server 2007 use the same X-headers to specify that a message has already been journaled and also to identify journal reports. An Exchange 2010 Hub Transport server won't generate a duplicate journal report for a message that's already been journaled by another Exchange 2010 or Exchange 2007 Hub Transport server. Journaling considerations for organizations that contain Exchange Server 2003 and Exchange 2010 servers are covered in Understanding Journaling in a Mixed Exchange 2003 and Exchange 2010 Environment.

Although journaling in Exchange 2010 is similar to journaling in Exchange 2007, there are some differences in the journal rule object. When you install the first Exchange 2010 Hub Transport server in an Exchange 2007 environment, Setup creates a new container for Exchange 2010 journal rules, converts all Exchange 2007 journal rules to the Exchange 2010 format, and stores them in this new container in Active Directory. After Setup completes, the Exchange 2010 journal rule collection is identical to the Exchange 2007 journal rule collection. The same journal rules are applied to messages at the first Hub Transport server that handles the messages, regardless of whether it's running Exchange 2010 or Exchange 2007.

Managing Journal Rules in Coexistence

During the time your Exchange organization contains both Exchange 2010 and Exchange 2007 Hub Transport servers, you must manage Exchange 2010 journal rules from the EMC or the Shell on an Exchange 2010 server, and Exchange 2007 journal rules from the EMC or the Shell on an Exchange 2007 server.

To help you keep journal rules consistent in Exchange 2010 and Exchange 2007, when you create or modify journal rules by using the EMC or the Shell in Exchange 2010, these tools provide you helpful messages prompting you to make the same changes in the Exchange 2007 environment.

Prerequisites

Your organization contains both Exchange 2010 and Exchange 2007 Hub Transport servers.

Use the Shell to export the journal rule collection from Exchange 2007

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Journaling" entry in the Messaging Policy and Compliance Permissions topic.

Note

You can't use the EMC to export the journal rule collection from Exchange 2007.

This example exports the Exchange 2007 journal rule collection. In the first step, the Export-JournalRuleCollection cmdlet is used to export Exchange 2007 journal rules and store them in a variable. In the second step, the Set-Content cmdlet is used to save exported journal rules from the variable to the Ex2007-JournalRules.xml file in the C:\MyDocs folder. You must perform this procedure on an Exchange 2010 Hub Transport server because the Exchange 2010 Export-JournalRuleCollection cmdlet is aware of both journal rule formats, and it exports the Exchange 2007 journal rules when you use the ExportLegacyRules switch.

$file = Export-JournalRuleCollection -ExportLegacyRules
Set-Content -Path "C:\MyDocs\Ex2007-JournalRules.xml" -Value $file.FileData -Encoding Byte

For detailed syntax and parameter information, see the following topics:

Use the Shell to import the journal rule collection to Exchange 2010

Warning

When you import journal rules, all Exchange 2010 journal rules are replaced with the rules imported from the .xml file. We recommend that you test this procedure in a test environment before implementing it in a production environment. To make sure you can roll back to the previous state, we recommend that you export the existing Exchange 2010 journal rules to a file before importing the Exchange 2007 journal rules. If you plan to save the file in the same location where you've saved the exported Exchange 2007 journal rules, use distinct and descriptive file names for the journal rules exported from each version.

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Journaling" entry in the Messaging Policy and Compliance Permissions topic.

Note

You can't use the EMC to import the journal rule collection to Exchange 2010.

This example imports the journal rule collection from the Ex2007-JournalRules.xml file to the Exchange 2010 journal rule collection. In the first step, the Get-Content cmdlet is used to retrieve data from the .xml file to the variable $Data. In the second step, the Import-JournalRuleCollection cmdlet is used to import the rules from the variable $Data.

[Byte[]]$Data = Get-Content -Path "C:\MyDocs\Ex2007-JournalRules.xml" -Encoding Byte -ReadCount 0
Import-JournalRuleCollection -FileData $Data

For detailed syntax and parameter information, see the following topics:

Other Tasks

After you export or import the journal rule collection, you may also want to:

 © 2010 Microsoft Corporation. All rights reserved.