New-MessageClassification

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-06-28

使用 New-MessageClassification cmdlet 可以在 Exchange 组织中新建邮件分类实例。新建邮件分类之后，可以将邮件分类指定为传输规则谓词。必须先使用 Export-OutlookClassification.ps1 脚本文件创建的邮件分类 XML 文件更新最终用户系统，Microsoft Office Outlook 2007 和 Outlook Web Access 2007 用户才能对邮件应用邮件分类。Export-OutlookClassification.ps1 脚本文件位于 \Program Files\Microsoft\Exchange Server\Scripts 目录中。

新建邮件分类时，该分类没有区域设置。默认情况下，新邮件分类用于所有区域设置。定义了默认邮件分类之后，可以通过运行 New-MessageClassification cmdlet 以及指定要本地化的默认邮件分类标识，添加新的分类区域设置。

语法

New-MessageClassification -Name <String> -DisplayName <String> -SenderDescription <String> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

详细说明

要运行 New-MessageClassification cmdlet，必须为您使用的帐户委派以下角色：

• Exchange 组织管理员角色

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

参数

参数	必需	类型	说明
DisplayName	必需	System.String	使用 DisplayName 参数可以指定邮件分类实例的显示名。显示名出现在 Office 2007 中，Outlook 用户在发送邮件之前使用显示名来选择合适的邮件分类。 注意： 发件人的计算机上必须存在邮件分类 XML 文件，才能显示其显示名。 如果将 UserDisplayEnabled 参数设置为 $true，即使未安装任何邮件分类 XML 文件，也将显示收件人的显示名。 如果指定的名称包含空格，则必须将整个名称放在引号中，例如 "Display Name"。DisplayName 参数只能包含 64 个或更少的字符。
Identity	必需	Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter	使用此参数可以创建现有邮件分类的转换版本。还必须指定 Locale 参数。Identity 参数可以接受字符串值，该值是现有邮件分类的 Name 值。
Locale	必需	System.Globalization.CultureInfo	为 Locale 参数指定区域性代码可以创建区域设置特定的邮件分类版本。新建区域设置特定版本时，还必须传递默认的现有邮件分类的 Identity 参数。 Locale 参数的有效输入为在 CultureInfo 上提供的 Microsoft .NET 类库类参考的“区域性名称”列中列出的字符串名称。
Name	必需	System.String	使用此参数可以指定邮件分类实例的管理名。该名称用于管理邮件分类实例。如果指定的名称包含空格，则必须将整个名称放在引号中，例如 "Adminstrative Name"。Name 参数只能包含 256 个或更少的字符。
SenderDescription	必需	System.String	使用此参数向发件人说明邮件分类要实现的目的。Outlook 用户在发送邮件之前，使用在此参数中输入的文本来选择合适的邮件分类。为该说明加上引号，例如 "This is the sender description that explains when to use this message classification"。SenderDescription 参数只能包含 1024 个或更少的字符。
ClassificationID	可选	System.Guid	使用此参数可以指定要导入并用于 Exchange 组织的现有邮件分类的分类标识。如果配置的邮件分类跨越同一个企业中的两个 Exchange 林，则使用此参数。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名，请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入和读取本地 Active Directory 应用程序模式 (ADAM) 实例。
RecipientDescription	可选	System.String	使用此参数向收件人说明邮件分类要实现的目的。Outlook 用户在接收具有此邮件分类的邮件时，会看到在此参数中输入的文本。为该说明加上引号，例如 "This is the recipient description that explains how to treat the message that has been classified"。RecipientDescription 参数只能包含 1024 个或更少的字符。 如果没有为此参数输入值，则将使用为 SenderDescription 输入的说明。
TemplateInstance	可选	System.Management.Automation.PSObject	将现有对象提供给 TemplateInstance 参数时，该命令使用该对象的配置在本地服务器或目标服务器上创建对象的完全相同的副本。
UserDisplayEnabled	可选	System.Boolean	使用此参数可以指定为 DisplayName 和 RecipientDescription 参数输入的值是否显示在收件人的 Outlook 邮件中。 如果将 UserDisplayEnabled 参数设置为 $false，则发送给收件人并且具有此邮件分类的邮件将不会显示任何分类信息。 默认值为 $true。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

示例

以下代码示例显示使用 New-MessageClassification cmdlet 的三个示例。

第一个示例显示有必需参数的 New-MessageClassification 命令。

第二个示例显示如何为现有邮件分类创建区域设置特定的版本（西班牙语 - 西班牙）。

第三个示例显示如何为现有邮件分类创建另一个区域设置特定的版本（西班牙语 - 墨西哥）。

New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "España Example " -SenderDescription "Este es el texto de la descripción"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "México Example" -SenderDescription "Este es el texto de la descripción"