New-ManagedFolder
此 cmdlet 仅在 Exchange Server 2010 中可用。
使用 New-ManagedFolder cmdlet 可以为邮件记录管理 (MRM) 创建托管文件夹对象。
此命令不接受管道输入。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
ManagedDefaultFolder
New-ManagedFolder
[-Name] <String>
-DefaultFolderType <DefaultManagedFolderType>
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
ManagedCustomFolder
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 个月的保留时间,为第二个文件夹分配 1 年的保留时间。 必须使用 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
适用:Exchange Server 2010
BaseFolderOnly 参数指定是应将托管内容设置只应用于托管文件夹,还是将其应用于该文件夹及其所有子文件夹。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Comment
适用:Exchange Server 2010
“注释”参数指定要在 Microsoft Office Outlook 2007 和 Microsoft Office Outlook Web App 中的文件夹中显示的默认管理员注释。 评论最多可包含 255 个字符(包括空格)。
参数属性
| 类型: | String |
| 默认值: | 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,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultFolderType
适用:Exchange Server 2010
DefaultFolderType 参数指定要创建的默认文件夹的类型,如“收件箱”或“已删除邮件”。
托管文件夹邮箱策略只能具有每种默认文件夹类型的一个托管文件夹。 可以创建特定类型的其他默认文件夹(如收件箱),并将其添加到不同的邮箱策略。 这允许您为不同的用户集的特定默认文件夹类型分配不同的托管内容设置。
例如,可以有两个默认类型的“收件箱”文件夹,一个文件夹的托管内容设置设置为将邮件保留一个月,另一个文件夹的设置设置为将邮件保留一年。 每个托管默认文件夹都应具有唯一名称, (使用名称参数) 分配。
如果没有为 DefaultFolderType 参数输入值,则该文件夹会被视为托管自定义文件夹。
可以指定的默认文件夹类型包括:
- 日历
- 联系人
- DeletedItems
- 草稿
- Inbox
- JunkEmail
- 日志
- 注意
- 发件箱
- SentItems
- 任务
- 全部
- ManagedCustomFolder
- RssSubscriptions
- SyncIssues
- ConversationHistory
参数属性
| 类型: | DefaultManagedFolderType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ManagedDefaultFolder
| Position: | Named |
| 必需: | True |
| 来自管道的值: | 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 参数指定用户邮箱中显示的文件夹名称。 文件夹名称最多可包含 255 个字符。 不能为托管的默认文件夹(如收件箱)设置 FolderName 参数。
不应将 FolderName 参数与 Name 参数相混淆。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ManagedCustomFolder
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-LocalizedComment
适用:Exchange Server 2010
LocalizedComment 参数指定本地化管理员注释及其语言。 当 Outlook 2007 的语言设置与此参数中指定的区域设置之一匹配时,将显示相应的本地化注释。 注释必须采用 ISOLanguageCode:Comment (格式,例如,-LocalizedComment EN-US:“这是美国英语的本地化批注”) 。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-LocalizedFolderName
适用:Exchange Server 2010
LocalizedFolderName 参数指定本地化文件夹名称及其语言。 当 Outlook 2007 的语言设置与此参数中指定的区域设置之一匹配时,将显示相应的本地化文件夹名称。 文件夹名称必须采用 ISOLanguageCode:FolderName (格式,例如 -LocalizedFolderName EN-US:“Business Critical”) 。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ManagedCustomFolder
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-MustDisplayCommentEnabled
适用:Exchange Server 2010
MustDisplayCommentEnabled 参数指定是否设置 Outlook 2007 使用的标志,以防止用户最小化 Outlook 2007 和 Outlook Web App) 中可见的文件夹注释 (。 如果存在 MustDisplayCommentEnabled 参数并设置为 $true,则该参数将设置 Outlook 2007 用于防止用户最小化文件夹注释的标志。 如果参数不存在或设置为 $false,则用户可以最小化评论。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
适用:Exchange Server 2010
Name 参数为 Active Directory 中的托管文件夹对象指定一个唯一名称。 该名称最多可包含 65 个字符。 FolderName 参数指定向客户端中的用户显示的文件夹名称,而 Exchange 管理工具使用 Name 参数来表示托管文件夹对象。
不应将 Name 参数与 FolderName 参数相混淆。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-StorageQuota
适用:Exchange Server 2010
StorageQuota 参数指定邮箱文件夹的存储大小限制。 文件夹大小超过此限制时,可能不会添加其他项目。 存储大小限制可以以千字节 (KB) 或 MB (MB) 为单位指定,例如 100 KB 或 5 MB。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ManagedCustomFolder
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Server 2010
WhatIf 开关显示命令执行的操作,而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | WI |
参数集
(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 不返回任何数据。