New-ManagedFolder
此 cmdlet 仅在 2010 Exchange Server可用。
使用 New-ManagedFolder cmdlet 可以为邮件记录管理 (MRM) 创建托管文件夹对象。
此命令不接受管道输入。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
New-ManagedFolder
[-Name] <String>
-DefaultFolderType <DefaultManagedFolderType>
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
New-ManagedFolder
[-Name] <String>
-FolderName <String>
[-LocalizedFolderName <MultiValuedProperty>]
[-StorageQuota <Unlimited>]
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
说明
New-ManagedFolder cmdlet 在 Active Directory 中创建新的托管文件夹。 创建新的托管文件夹对象后,需要执行以下步骤将其用于 MRM:
- 为文件夹创建托管内容设置。 有关信息,请参阅 创建托管内容设置。
- 将托管文件夹链接到现有“托管文件夹邮箱策略”,或创建一个托管文件夹邮箱策略并将托管文件夹链接到该策略。
- 将托管文件夹邮箱策略应用于用户的邮箱。 有关信息,请参阅向用户应用托管文件夹邮箱策略。
- 确保已计划托管文件夹助理或手动运行托管文件夹助理。 有关计划托管文件夹助理的信息,请参阅 配置托管文件夹助理。 当托管文件夹助手运行时,它会将默认文件夹配置为托管文件夹,并使用指定的设置在用户邮箱中创建任何托管自定义文件夹。
- 有关在 Microsoft Exchange Server 2010 中实现 MRM 的步骤的详细信息,请参阅部署消息记录管理。
默认情况下,使用此 cmdlet 创建托管自定义文件夹。 但是,也可以使用 DefaultFolderType 参数创建托管默认文件夹的其他副本,以指定要创建的默认文件夹类型 (例如,) 其他收件箱文件夹。 创建托管默认文件夹的多个副本时,可以为每个副本分配不同的内容设置。 例如,可以有两个收件箱文件夹,一个名为 InboxSixMonths,另一个名为 InboxOneYear。 然后,可以使用New-ManagedContentSettings cmdlet (或使用Exchange 管理控制台) 中的“新建托管内容设置”向导,将第一个文件夹的保留时间分配给第一个文件夹 6 个月,将保留时间分配给第二个文件夹一年。 必须使用 Name 参数) 为创建的每个托管默认文件夹分配唯一名称 (。 但是,用户始终会看到未更改的默认文件夹名称。 在该示例中,无论为用户分配的是 InboxSixMonths 文件夹还是 InboxOneYear 文件夹,他们在其邮箱中看到的收件箱都标记为“收件箱”。 尽管可以使用 Set-ManagedFolder 命令 FolderName 参数) 为托管自定义文件夹 (用户在其邮箱中看到的文件夹名称重新分配,但无法更改用户针对托管默认文件夹看到的文件夹名称。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
本示例将创建最大容量为 1 MB 的托管文件夹。
示例 2
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
本示例将创建默认文件夹名称和注释为英语、本地化文件夹名称和注释为西班牙语和法语的托管文件夹。
示例 3
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox
本示例将创建默认文件夹 Inbox 的实例。
参数
-BaseFolderOnly
BaseFolderOnly 参数指定是应将托管内容设置只应用于托管文件夹,还是将其应用于该文件夹及其所有子文件夹。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Comment
Comment 参数指定要在 Office Outlook 2007 Microsoft 和 Office Outlook Web App Microsoft 文件夹中显示的默认管理员注释。 注释最多可以包含 255 个字符,包括空格。
Type: | String |
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 |
-DefaultFolderType
DefaultFolderType 参数指定要创建的默认文件夹的类型,如“收件箱”或“已删除邮件”。
托管文件夹邮箱策略只能具有每种默认文件夹类型的一个托管文件夹。 可以创建特定类型的其他默认文件夹(如收件箱),并将其添加到不同的邮箱策略。 这允许你为不同的用户组分配不同的特定默认文件夹类型的不同托管内容设置。
例如,可以有两个“收件箱”类型的默认文件夹,一个文件夹的托管内容设置设置为将邮件保留一个月,一个文件夹具有将邮件保留一年的设置。 每个托管默认文件夹都应具有使用 Name 参数) 分配 (唯一名称。
如果没有为 DefaultFolderType 参数输入值,则该文件夹会被视为托管自定义文件夹。
可以指定的默认文件夹类型包括:
- 日历
- 联系人
- DeletedItems
- 草稿
- Inbox
- JunkEmail
- 日志
- 注意
- 发件箱
- SentItems
- 任务
- 全部
- ManagedCustomFolder
- RssSubscriptions
- SyncIssues
- ConversationHistory
Type: | DefaultManagedFolderType |
Position: | Named |
Default value: | None |
Required: | True |
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 参数指定在用户邮箱中显示的文件夹名称。 文件夹名称最多可以包含 255 个字符。 无法为托管的默认文件夹(如收件箱)设置 FolderName 参数。
不应将 FolderName 参数与 Name 参数相混淆。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-LocalizedComment
LocalizedComment 参数指定本地化的管理员注释及其语言。 当 Outlook 2007 的语言设置与此参数中指定的某个区域设置匹配时,将显示相应的本地化注释。 注释的格式必须为 ISOLanguageCode:Comment (例如-LocalizedComment EN-US:“这是美国英语的本地化注释”) 。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-LocalizedFolderName
LocalizedFolderName 参数指定本地化的文件夹名称及其语言。 当 Outlook 2007 的语言设置与此参数中指定的某个区域设置匹配时,将显示相应的本地化文件夹名称。 文件夹名称的格式必须为 ISOLanguageCode:FolderName (例如 -LocalizedFolderName EN-US:“业务关键”) 。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MustDisplayCommentEnabled
MustDisplayCommentEnabled 参数指定是否设置 Outlook 2007 使用的标志,以防止用户尽量减少 Outlook 2007 和 Outlook Web App) 中可见的文件夹注释 (。 如果 MustDisplayCommentEnabled 参数存在并将其设置为 $true,则参数将设置 Outlook 2007 使用的标志,以防止用户最小化文件夹注释。 如果参数不存在或设置为$false,用户可以最小化注释。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Name
Name 参数指定 Active Directory 中托管文件夹对象的唯一名称。 名称最多可以包含 65 个字符。 FolderName 参数指定在客户端中向用户显示的文件夹名称,而 Exchange 管理工具使用 Name 参数来表示托管文件夹对象。
不应将 Name 参数与 FolderName 参数相混淆。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StorageQuota
StorageQuota 参数指定邮箱文件夹的存储大小限制。 当文件夹大小超过此限制时,不能添加任何其他项目。 存储大小限制可以指定为 kb (KB) 或 MB (MB) ,例如 100 KB 或 5 MB。
Type: | Unlimited |
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 不返回任何数据。