Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

How to Use Exchange Management Shell Scripts for Messaging Records Management

 

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

Topic Last Modified: 2007-08-07

This topic explains how to use scripts in the Exchange Management Shell to manage messaging records management (MRM) in Microsoft Exchange Server 2007.

To perform this procedure, 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 Server 2007, see Permission Considerations.

noteNote:
Managed custom folders are a premium feature of MRM. Each mailbox that has managed custom folders requires an Exchange Server Enterprise client access license (CAL). Mailboxes with policies that include managed custom folders require an Exchange Server Enterprise CAL. To learn more about the licensing requirements for MRM, see "Client Access Licenses and MRM" in Understanding Messaging Records Management.
  1. Create a script by entering Exchange Management Shell commands in a text editor, as shown in the sample script that follows.

  2. Save the text file for the script with the .ps1 file extension (for example, MRM_Sample_Script.ps1).

  3. At the command prompt of the Exchange Management Shell, enter the path and file name of the script (for example, C:\Scripts\MRM_Sample_Script.ps1, or .\MRM_Sample_Script.ps1 for a script in the working directory).

The following is a sample script for messaging records management. For an explanation of the actions performed, see the comments within the script.

# MRM_Sample_Script.ps1

# This script demonstrates the fundamentals of performing messaging records management by running scripts in the Exchange Management Shell.

# Create a new managed custom folder.
New-ManagedFolder -Name "Important E-mail" -FolderName "Business Folder A" 

# Create a variable, "$age," to use in the next command.
$age = New-TimeSpan -Day 30

# Create managed content settings for the new managed custom folder that delete items after 30 days.
New-ManagedContentSettings -Name "Retention settings for Business Folder A" -FolderName "Business Folder A" -MessageClass VoiceMail -RetentionEnabled:$True -AgeLimitForRetention $Age -RetentionAction PermanentlyDelete

# Create a managed folder mailbox policy.
New-ManagedFolderMailboxPolicy -Name "Business Folder A" -ManagedFolderLinks "Important E-mail"

# Apply the managed folder mailbox policy to a mailbox.
Set-Mailbox -Identity Administrator -ManagedFolderMailboxPolicy "Policy A"

# Schedule the managed folder assistant to run the entire week.
$ServerName= cmd /c echo %computername%
Set-MailboxServer -ID $ServerName -ManagedFolderAssistantSchedule "Sun.12:00-Sun.11:00"

# Start the managed folder assistant. 
Start-ManagedFolderAssistant

For more information about messaging records management, see the following topics:

For more information about how to use the Exchange Management Shell commands to manage your Exchange 2007 organization, see New Administration Functionality in the Exchange Management Shell.

For more information about using scripts with the Exchange Management Shell, see Scripting with the Exchange Management Shell.

To ensure that you are reading the most up-to-date information and to find additional Exchange Server 2007 documentation, visit the Exchange Server TechCenter.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.