New-ManagedContentSettings

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-09-16

使用 New-ManagedContentSettings cmdlet 可以为托管文件夹创建新的托管内容设置。

语法

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

详细说明

“托管内容设置”是应用于托管文件夹以控制用户邮箱中的邮件生命期的设置。可以通过下列方式控制生命期：

  • 控制内容保留时间并删除不再需要的内容。

  • 将重要内容自动“日记”到邮箱以外的独立存储位置。

有关托管内容设置的详细信息，请参阅管理邮件记录管理。

若要运行 New-ManagedContentSettings cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 组织管理员角色

有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

FolderName

必需

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

FolderName 参数指定应用托管内容设置的托管文件夹的名称或 GUID。

MessageClass

必需

System.String

MessageClass 参数指定应用这些内容设置中任何过期和日记配置设置的邮件类型。

  • 参数值必须是一个特定的邮件类，例如，IPM.NOTE.SMIME 或自定义邮件类。

自定义邮件类的有效参数值包括：

  • 特定邮件类（例如 IPM.NOTE）

  • 星号通配符 (*)，表示内容设置适用于所有邮件类。

  • 包含星号通配符的特定邮件类。星号通配符必须作邮件类中的最后一个字符出现。

    示例：

    • IPM.NOTE*（它包括 IPM.NOTE 及所有子类。）

    • IPM.NOTE.*（它包括 IPM.NOTE 的子类，但不包括 IPM.NOTE 本身）

    • *.NOTE 和 IPM.*.NOTE 不可接受。

note注意：
使用通配符时，这些策略只应用于没有特定内容设置的邮件类。因此，IPM.NOTE.SMIME 会覆盖 IPM.NOTE.*。
note注意：
特定设置取代常规设置。例如，“语音邮件”会取代“所有邮箱内容”。
下表描述了一些常见的邮件类型并提供了必须使用的值：

  • 对于“所有邮箱内容邮件”类型，使用值 *。

  • 对于“日历项目”邮件类型，使用值 IPM.Appointment*。

  • 对于“联系人邮件”类型，使用值 IPM.Contact*。

  • 对于“文档”邮件类型，使用值 IPM.Document*。

  • 对于“传真”邮件类型，使用值 IPM.Note.Microsoft.Fax。

  • 对于“日志”项邮件类型，使用值 IPM.Activity。

  • 对于“会议请求、响应和取消”邮件类型，使用值 IPM.Schedule*。

  • 对于“注释”邮件类型，使用值 IPM.StickyNote。

  • 对于“公告”邮件类型，使用值 IPM.Post。

  • 对于“RSS 项”邮件类型，使用值 IPM.Post.RSS。

  • 对于“任务”类型，使用值 IPM.Task*。

  • 对于“语音邮件”邮件类型，使用值 IPM.Note.Microsoft.Voicemail*。

名称

必需

System.String

Name 参数为托管内容设置指定唯一的名称。

AddressForJournaling

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

AddressForJournaling 参数指定将成为日记操作目标的存储库地址。如果此参数不存在且 JournalingEnabled 参数设置为 $true，则返回错误。

AgeLimitForRetention

可选

System.Nullable

AgeLimitForRetention 参数指定对邮件强制执行保留的期限。期限对应于从发送邮件的日期算起的天数，或者对应于从创建邮件的日期算起的天数（如果其未发送邮件）。如果此参数不存在且 RetentionEnabled 参数设置为 $true，则返回错误。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置信息写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。

JournalingEnabled

可选

System.Boolean

JournalingEnabled 参数指示在其设置为 $true 时启用日记功能。

LabelForJournaling

可选

System.String

LabelForJournaling 参数指定将要附加到邮件后的标签。该标签将由目标存储使用，以确定邮件内容并强制执行相应的策略。

MessageFormatForJournaling

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

MessageFormatForJournaling 参数使管理员可以指定应该将邮件记录为 Microsoft Outlook .msg 格式或传统的 Outlook MAPI 格式。

MoveToDestinationFolder

可选

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

MoveToDestinationFolder 参数指定移动操作的目标文件夹。

目标文件夹必须是现有的托管自定义文件夹。如果不是，则会返回错误。如果不存在 MoveToDestinationFolder 参数且保留操作为 MoveToFolder，则会返回错误。

RetentionAction

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

RetentionAction 参数指定下列操作之一：

  • 标记为已过保留期限

  • 移动到托管自定义文件夹

  • 移动到已删除邮件文件夹

  • 删除但允许恢复

  • 永久删除

如果此参数不存在且 RetentionEnabled 参数设置为 $true，则返回错误。

RetentionEnabled

可选

System.Boolean

RetentionEnabled 参数指定在其设置为 $true 时启用保留功能。

TemplateInstance

可选

System.Management.Automation.PSObject

将现有对象提供给 TemplateInstance 参数时，该命令使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。

TriggerForRetention

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

TriggerForRetention 参数指示用于开始保留期的起始日期。在发送邮件或将邮件移动到特定文件夹特定天数之后，该邮件可以达到其保留期限。

该值对应于 Active Directory 中 msExchELCFlags 属性的 0x4 位。如果邮件根据移动的日期过期，则将该标志设置为 $true；如果邮件根据发送日期过期，则设置为 $false。如果此参数不存在且 RetentionEnabled 参数设置为 $true，则返回错误。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

  

异常

异常 说明

  

示例

在第一个示例中，New-ManagedContentSettings 命令用来创建 Calendar 邮件类的托管内容设置，并将其命名为 MyCalendarContentSettings。该管理内容设置将应用于默认的文件夹“日历”。启用了保留期限，且邮件在 30 天后移动到已删除邮件文件夹中。

在第二个示例中，使用名为 RemoveArchiveStubs 的托管内容设置删除了用户收件箱中已存档内容的存根（属于名为 IPM.Note.Archive.Shortcut 的自定义邮件类）。

有关自定义邮件类的详细信息，请参阅本主题中的“MessageClass”参数说明及 Microsoft 知识库文章 241235 如何使用窗体管理员实用程序全局更改 Outlook 中的默认窗体中“关于邮件类”一节。

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"