New-ManagedContentSettings

此 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项是否基于交付日期过期。

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

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

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

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

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。