通过

New-ManagedContentSettings

模块:
Exchange PowerShell

此 cmdlet 仅在 2010 Exchange Server可用。

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

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

语法

Default （默认值） 

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

适用：Exchange Server 2010

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

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

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

参数属性

类型:RecipientIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AgeLimitForRetention

适用：Exchange Server 2010

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

参数属性

类型:EnhancedTimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

适用：Exchange Server 2010

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：Exchange Server 2010

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

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FolderName

适用：Exchange Server 2010

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

参数属性

类型:ELCFolderIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-JournalingEnabled

适用：Exchange Server 2010

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-LabelForJournaling

适用：Exchange Server 2010

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MessageClass

适用：Exchange Server 2010

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。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MessageFormatForJournaling

适用：Exchange Server 2010

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

  • UseMsg Outlook .msg 格式
  • UseTnef Outlook MAPI 格式

参数属性

类型:JournalingFormat
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MoveToDestinationFolder

适用：Exchange Server 2010

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

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

参数属性

类型:ELCFolderIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

适用：Exchange Server 2010

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RetentionAction

适用：Exchange Server 2010

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

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

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

参数属性

类型:RetentionAction
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RetentionEnabled

适用：Exchange Server 2010

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TriggerForRetention

适用：Exchange Server 2010

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

有效值包括：

  • WhenDelivered
  • WhenMoved

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

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

参数属性

类型:RetentionDateType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：Exchange Server 2010

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

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

输出

Output types

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