New-ManagedFolder (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-05

使用 New-ManagedFolder cmdlet 可以为邮件记录管理 (MRM) 创建新的托管文件夹。“托管文件夹”是用户邮箱中应用了 MRM 的文件夹。托管文件夹的类型如下:

  • 默认情况下,托管默认文件夹(如收件夹)出现在用户的 Microsoft Office Outlook 2007 邮箱中。

  • 托管自定义文件夹由 Exchange 管理员专门为 MRM 创建。

对托管文件夹中邮件的保留和托管由应用于托管文件夹的托管内容设置控制。

语法

New-ManagedFolder -Name <String> -FolderName <String> [-Comment <String>] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-StorageQuota <Unlimited>] [-TemplateInstance <PSObject>]

New-ManagedFolder -Name <String> -DefaultFolderType <Nullable> [-Comment <String>] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-TemplateInstance <PSObject>]

详细说明

使用 New-ManagedFolder cmdlet 可以在 Active Directory 目录服务中创建新的托管文件夹。然后,将新的托管文件夹用于邮件记录管理:

  1. 将“托管内容设置”应用到文件夹。

  2. 将文件夹链接到“托管文件夹邮箱策略”。

  3. 将邮箱策略链接到用户邮箱。

  4. 运行“托管文件夹助理”,该程序可以使用指定的设置将新的托管文件夹放置到用户邮箱中。

  5. 有关在 Microsoft Exchange Server 2007 中实施邮件记录管理所需步骤的详细信息,请参阅部署邮件记录管理

默认情况下,使用此 cmdlet 创建托管自定义文件夹。但是,也可以使用 DefaultFolderType 参数创建托管默认文件夹的其他副本,方法是使用此参数指定要创建的默认文件夹类型(例如,其他收件箱文件夹)。创建托管默认文件夹的多个副本时,可以为每个副本指定不同的内容设置。例如,您可能拥有两个收件箱文件夹,一个名为 InboxSixMonths,另一个名为 InboxOneYear。此时,您可以使用 New-ManagedContentSettings cmdlet(或使用 Exchange 管理控制台中的新建托管内容设置向导)为第一个文件夹指定 6 个月的保留时间,为第二个文件夹指定 1 年的保留时间。必须为您创建的每个托管默认文件夹指定一个唯一名称(使用 Name 参数)。但是,用户始终看到的是未经更改的默认文件夹名称。在该示例中,无论用户指定的是 InboxSixMonths 文件夹还是 InboxOneYear 文件夹,他们在其邮箱中看到的“收件箱”都将标记为“收件箱”。尽管可以为托管自定义文件夹重新指定用户在其邮箱中看到的文件夹名称(使用 Set-ManagedFolder 命令的 FolderName 参数),但是无法更改用户所看到的托管默认文件夹的文件夹名称。

开始之前

若要运行 New-ManagedFolder cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange 组织管理员角色

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

此命令不接受管道输入。

参数

参数 必需 类型 说明

DefaultFolderType

必需

System.Nullable

DefaultFolderType 参数指定要创建的默认文件夹类型(例如,其他收件箱文件夹)。拥有默认文件夹的多个副本时,可以为每个副本指定不同的内容设置。例如,您可能拥有两个收件箱文件夹,一个文件夹中的内容将保留 1 个月,另一个文件夹中的内容将保留 1 年。必须为多个托管默认文件夹的每个文件夹指定一个唯一的名称(使用 Name 参数)。

如果没有为 DefaultFolderType 参数输入值,则将创建一个托管自定义文件夹。可以指定的文件夹类型包括:

  • Calendar

  • 联系人

  • DeletedItems

  • Drafts

  • Inbox

  • JunkEmail

  • Journal

  • 便笺

  • Outbox

  • SentItems

  • 任务

  • All

  • ManagedCustomFolder

  • RssSubscriptions

  • SyncIssues

  • ConversationHistory

FolderName

必需

System.String

FolderName 参数指定文件夹在用户的邮箱中出现时的名称。无法为托管默认文件夹设置 FolderName 值。此字符串最长为 255 个字符。

note注意:
不应将 FolderName 参数与 Name 参数相混淆。

Name

必需

System.String

Name 参数为文件夹指定唯一名称。该值由管理员用作文件夹的句柄。它不出现在用户的邮箱中。此字符串最长为 65 个字符。

note注意:
不应将 Name 参数与 FolderName 参数相混淆。

Comment

可选

System.String

Comment 参数指定 Microsoft Outlook 2007 和 Outlook Web Access 中与文件夹一起显示的默认管理员注释。此字符串最长为 255 个字符。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定从 Active Directory 检索数据的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。

LocalizedComment

可选

Microsoft.Exchange.Data.MultiValuedProperty

LocalizedComment 参数指定本地化的管理员注释及其语言。当 Outlook 2007 的语言设置与为此参数值指定的语言匹配时,将显示本地化注释而不是默认注释。注释的格式必须为 ISOLanguageCode:Comment(例如,-LocalizedComment EN-US:"This is a localized comment in US English")。

LocalizedFolderName

可选

Microsoft.Exchange.Data.MultiValuedProperty

LocalizedFolderName 参数指定本地化文件夹名称及其语言。当 Outlook 2007 的语言设置与为此参数值指定的语言匹配时,将显示本地化文件夹名称而不是默认文件夹名称。注释的格式必须为 ISOLanguageCode:Comment(例如,-LocalizedFolderName EN-US:"This is a localized folder name in US English")。

MustDisplayCommentEnabled

可选

System.Boolean

如果 MustDisplayCommentEnabled 参数存在且设置为 $true,则该参数将设置一个标记,Outlook 2007 使用该标记来防止用户最小化文件夹注释(可在 Outlook 2007 和 Outlook Web Access 看到)。如果该参数不存在或设置为 $false,则用户可以最小化注释。

StorageQuota

可选

Microsoft.Exchange.Data.Unlimited

StorageQuota 参数指定邮箱文件夹的存储大小限制。当文件夹大小超过此限制时,不能添加其他项目。邮箱大小可以指定为千字节 (KB) 或兆字节 (MB)(例如,100 KB 或 5 MB)。

TemplateInstance

可选

System.Management.Automation.PSObject

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

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

在第一个示例中,New-ManagedFolder 命令用于新建一个具有最大容量为 1 MB 的托管文件夹。

在第二个示例中,New-ManagedFolder 命令用于新建托管文件夹,该文件夹具有默认的文件夹名称和英文注释、经过西班牙语和法语本地化的文件夹名称,以及经过西班牙语本地化的注释。

在第三个示例中,将为收件箱默认文件夹新建实例。

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox