New-ManagedFolder

此 cmdlet 仅在 2010 Exchange Server可用。

使用 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 个月的保留时间,将保留时间分配给第二个文件夹一年。 必须使用 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

Comment 参数指定要随 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,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

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

参数集

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

-DefaultFolderType

适用:Exchange Server 2010

DefaultFolderType 参数指定要创建的默认文件夹的类型,如“收件箱”或“已删除邮件”。

托管文件夹邮箱策略只能具有每种默认文件夹类型的一个托管文件夹。 可以创建特定类型的其他默认文件夹(如收件箱),并将其添加到不同的邮箱策略。 这允许你为不同的用户组分配不同的特定默认文件夹类型的不同托管内容设置。

例如,可以有两个“收件箱”类型的默认文件夹,一个文件夹的托管内容设置设置为将邮件保留一个月,一个文件夹具有将邮件保留一年的设置。 每个托管默认文件夹都应具有使用 Name 参数) 分配 (唯一名称。

如果没有为 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 (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
别名:无线

参数集

(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 不返回任何数据。