New-ManagedFolder
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2010-11-29
使用 New-ManagedFolder cmdlet 可以为邮件记录管理 (MRM) 创建新的托管文件夹。“托管文件夹”是用户邮箱中应用了 MRM 的文件夹。托管文件夹的类型如下：
默认情况下，用户的 Microsoft Office Outlook 2007 邮箱中存在托管默认文件夹（如收件箱）。托管默认文件夹只要求拥有 Exchange Server Standard 客户端访问许可证 (CAL)。
托管自定义文件夹由 Exchange 管理员专门为 MRM 创建。托管自定义文件夹是 MRM 的一项高级功能。每个具有托管自定义文件夹的邮箱都需要 Exchange Server 企业版 CAL。
对托管文件夹中邮件的保留和托管由应用于托管文件夹的托管内容设置控制。
语法
New-ManagedFolder -Name <String> -FolderName <String> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-StorageQuota <Unlimited>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
New-ManagedFolder -Name <String> -DefaultFolderType <Nullable> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 New-ManagedFolder cmdlet 在 Active Directory 目录服务中新建托管文件夹。然后，若要将新的托管文件夹用于邮件记录管理，请执行以下操作：
将“托管内容设置”应用到文件夹。
将文件夹链接到“托管文件夹邮箱策略”。
将邮箱策略链接到用户邮箱。
运行“托管文件夹助理”，该程序可以使用指定的设置将新的托管文件夹放置到用户邮箱中。
有关在 Microsoft Exchange Server 2007 中实施邮件记录管理所需步骤的详细信息，请参阅部署邮件记录管理。
默认情况下，使用此 cmdlet 创建托管自定义文件夹。但是，也可以使用 DefaultFolderType 参数创建托管默认文件夹的其他副本，方法是使用此参数指定要创建的默认文件夹类型（例如，其他收件箱文件夹）。创建托管默认文件夹的多个副本时，可以为每个副本指定不同的内容设置。例如，您可能拥有两个收件箱文件夹，一个名为 InboxSixMonths，另一个名为 InboxOneYear。然后，您可以使用 New-ManagedContentSettings cmdlet（或使用 Exchange 管理控制台中的新建托管内容设置向导）为第一个文件夹指定六个月的保留时间，为第二个文件夹指定一年的保留时间。必须（使用 Name 参数）为创建的每个托管默认文件夹指定一个唯一的名称。但是，用户始终看到的是未经更改的默认文件夹名称。在该示例中，无论为用户分配的是 InboxSixMonths 文件夹还是 InboxOneYear 文件夹，他们在其邮箱中看到的“收件箱”都将标记为“收件箱”。尽管可以为托管自定义文件夹重新指定用户在其邮箱中看到的文件夹名称（使用 Set-ManagedFolder 命令的 FolderName 参数），但是无法更改用户所看到的托管默认文件夹的文件夹名称。
开始之前
若要运行 New-ManagedFolder cmdlet，必须为您使用的帐户委派以下角色：
- Exchange 组织管理员角色
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
此命令不接受管道输入。
参数
| 参数 | 必需 | 类型 | 说明 | ||
|---|---|---|---|---|---|
DefaultFolderType |
必需 |
System.Nullable |
DefaultFolderType 参数指定要创建的默认文件夹类型（例如，其他收件箱文件夹）。拥有默认文件夹的多个副本时，可以为每个副本指定不同的内容设置。例如，您可能拥有两个收件箱文件夹，一个文件夹中的内容将保留 1 个月，另一个文件夹中的内容将保留 1 年。必须为多个托管默认文件夹的每个文件夹指定一个唯一的名称（使用 Name 参数）。 如果没有为 DefaultFolderType 参数输入值，则将创建一个托管自定义文件夹。可以指定的文件夹类型包括：
|
||
FolderName |
必需 |
System.String |
FolderName 参数指定文件夹在用户的邮箱中出现时的名称。无法为托管默认文件夹设置 FolderName 值。此字符串最长为 255 个字符。
|
||
Name |
必需 |
System.String |
Name 参数为文件夹指定唯一名称。该值由管理员用作文件夹的句柄。它不出现在用户的邮箱中。该字符串最长为 65 个字符。
|
||
BaseFolderOnly |
可选 |
System.Boolean |
BaseFolderOnly 参数用于避免托管文件夹助手将邮箱策略应用至托管文件夹的子文件夹中的内容。 |
||
Comment |
可选 |
System.String |
Comment 参数指定 Microsoft Outlook 2007 和 Outlook Web Access 中与文件夹一起显示的默认管理员注释。此字符串最长为 255 个字符。 |
||
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。 |
||
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 参数时，该命令使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。 |
||
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。 |
.gif "note")
注意：输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
异常
| 异常 | 说明 |
|---|---|
|
示例
在第一个示例中，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