New-ManagedContentSettings

 

适用于: Exchange Server 2010 SP2, Exchange Server 2010 SP3

上一次修改主题: 2015-03-09

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


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

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

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

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

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

您必须先获得权限,然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数未包含在分配给您的权限中,则您无法访问这些参数。若要查看所需的权限,请参阅邮件策略和遵从性权限主题中的“邮件记录管理”条目。

 

参数 必需 类型 描述

FolderName

必需

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

MessageClass

必需

System.String

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

此参数值可以是常用邮件类型(如日历项目)、特定邮件类(如 IPM.NOTE.SMIME)或自定义邮件类。可以使用下列已知邮件类型:

  • 对于“所有邮箱内容”,请使用值 *

  • 对于“日历项目”邮件类型,请使用值 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*

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

  • 特定邮件类(例如 IPM.NOTE)。

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

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

    IPM.NOTE*   包括 IPM.NOTE 及所有子类。

    IPM.NOTE.*   包括 IPM.NOTE 的子类,但不包括 IPM.NOTE 本身。

注释注意:
*.NOTEIPM.*.NOTE 是不可接受的格式。
注释注意:
使用通配符时,这些策略只能应用于没有特定内容设置的邮件类。因此,IPM.NOTE.SMIME 会覆盖 IPM.NOTE.*
注释注意:
特定设置取代常规设置。例如,Voicemail 会取代 AllMailboxContent。

Name

必需

System.String

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

AddressForJournaling

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

AddressForJournaling 参数指定收件人,以便向其发送日记邮件。

注释注意:
如果 JournalingEnabled 参数设置为 $true,则此参数是必需的。

AgeLimitForRetention

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 开关将导致命令暂停处理,并需要您在继续处理之前确认该命令将执行的操作。您无需使用 Confirm 开关指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定将此配置更改写入 Active Directory 的域控制器的完全限定域名 (FQDN)。

JournalingEnabled

可选

System.Boolean

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

LabelForJournaling

可选

System.String

LabelForJournaling 参数指定将附加到邮件的标签。该标签用于目标存储区,以便确定邮件内容并强制执行相应的策略。

MessageFormatForJournaling

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

MessageFormatForJournaling 参数指定进行邮件日记应使用的邮件格式。可以使用下列值:

  • UseMsg   Outlook .msg 格式

  • UseTnef   Outlook MAPI 格式

MoveToDestinationFolder

可选

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

目标文件夹必须是现有的托管自定义文件夹。如果不是,将返回错误。如果 MoveToDestinationFolder 参数不存在,且 RetentionAction 参数的值为 MoveToFolder,则返回错误。

Organization

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

保留 Organization 参数以供 Microsoft 内部使用。

RetentionAction

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

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

  • 标记为已过保留期限

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

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

  • 删除但允许恢复

  • 永久删除

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

RetentionEnabled

可选

System.Boolean

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

TriggerForRetention

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

TriggerForRetention 参数指定作为保留期开始日期的日期。在发送邮件或将邮件移动到文件夹特定天数后,该邮件可以达到其保留期限。

有效值包括:

  • WhenDelivered

  • WhenMoved

该值对应于 Active Directory 中 msExchELCFlags 属性的 0x4 位。如果邮件的到期日期以移动日期为依据,该标志设置为 $true;如果到期日期以发送日期为依据,则设置为 $false

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

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 开关指示命令模拟对对象执行的操作。通过使用 WhatIf 开关,您可以查看要发生的更改,而无需应用这些更改中的任何更改。您无需使用 WhatIf 开关指定值。

若要查看此 cmdlet 接受的输入类型,请参阅 Cmdlet 输入和输出类型。如果 cmdlet 的输入类型字段为空,则 cmdlet 不接受输入数据。

若要查看此 cmdlet 接受的返回类型(也称为输出类型),请参阅 Cmdlet 输入和输出类型。如果输出类型字段为空,则 cmdlet 不返回数据。

本示例为托管默认文件夹 Exec-DeletedItems 创建托管内容设置。添加到托管文件夹邮箱策略并应用到邮箱后,“已删除邮件”文件夹中的邮件将在发送日期后 30 天永久删除。

New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

本示例为 Calendar 邮件类创建托管内容设置 CS-Exec-Calendar。该托管内容设置将应用于默认文件夹“日历”。启用了保留期,邮件在 180 天后移动到“已删除邮件”文件夹中。

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180
 
显示: