New-ManagedContentSettings

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010

此 cmdlet 仅在 2010 Exchange Server可用。

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

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

说明

托管内容设置是与托管文件夹关联的设置，用于控制用户邮箱中项目的生命周期。通过以下方式控制寿命：

控制内容保留时间并删除不再需要的内容。
将重要内容自动“日记”到邮箱以外的独立存储位置。

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

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

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

本示例为托管默认文件夹 Exec-DeletedItems 创建托管内容设置。添加到托管文件夹邮箱策略并应用于邮箱时，“已删除邮件”文件夹中的项目将从传递之日起 30 天内永久删除。

示例 2

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

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

参数

-AddressForJournaling

AddressForJournaling 参数指定将日记邮件发送到的日记收件人。可以使用任何能够唯一标识该收件人的值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

如果 JournalingEnabled 参数设置为 $true，则此参数是必需的。

Type:	RecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AgeLimitForRetention

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

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-FolderName

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

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-JournalingEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LabelForJournaling

LabelForJournaling 参数指定附加到项的标签。目标存储区使用此标签来确定项的内容并强制实施相应的策略。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageClass

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

参数值可以是众所周知的邮件类型（如日历项目），也可以是特定的邮件类（如 IPM）。注意。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。注意* (包括 IPM。注意，所有子类) 或 IPM。NOTE.* (包括 IPM 的子类。请注意，但不是 IPM。请注意) 本身。 *.注意和 IPM.*。注意不是有效值。

注意：

使用通配符时，这些策略仅适用于没有特定内容设置的邮件类。因此，IPM。注意。SMIME 替代 IPM。注意。*。
特定设置取代常规设置，例如，Voicemail 取代 AllMailboxContent。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageFormatForJournaling

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

UseMsg Outlook .msg 格式
UseTnef Outlook MAPI 格式

Type:	JournalingFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MoveToDestinationFolder

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

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

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionAction

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

标记为已过保留期限
移动到托管自定义文件夹
移动到已删除邮件文件夹
删除但允许恢复
永久删除

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

Type:	RetentionAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TriggerForRetention

TriggerForRetention 参数指定被视为保留期开始日期的日期。在项目交付后或移动到文件夹之后的特定天数内，项目可以达到其保留限制。

有效值包括：

WhenDelivered
WhenMoved

此值对应于 Active Directory 中 msExchELCFlags 属性的 0x4 位。如果项将基于移动日期过期，则标志设置为$true，$false项是否基于交付日期过期。