С помощью командлета New-MessageClassification можно создать новый экземпляр классификации сообщений в организации Exchange. После создания новой классификации сообщений можно указать эту классификацию в качестве предиката правил транспорта. Перед тем, как пользователи Microsoft Office Outlook 2007 и Outlook Web Access 2007 смогут применить классификацию сообщений, необходимо обновить системы конечных пользователей XML-файлом классификации сообщений, созданным с помощью файла сценария Export-OutlookClassification.ps1. Файл сценария Export-OutlookClassification.ps1 размещается в каталоге \Program Files\Microsoft\Exchange Server\Scripts.

Новая классификация сообщений не имеет языковых настроек. По умолчанию новая классификация сообщений используется для всех языков. После определения классификации сообщений по умолчанию можно добавить новые языки в эту классификацию, используя командлет New-MessageClassification и указывая идентификатор классификации сообщений по умолчанию, которую необходимо локализовать.

Синтаксис

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>]]

Параметры

Параметр Обязательный Тип Описание

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 являются строковые имена, отображаемые в столбце Имя культурной среды в справке по классам библиотеки классов 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 не поддерживается на компьютерах, на которых установлена роль пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет запись только на локальный экземпляр ADAM (Active Directory Application Mode).

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 используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Пример

Следующий код содержит три примера использования командлета New-MessageClassification.

В первом примере кода показана команда New-MessageClassification с требуемыми параметрами.

Во втором примере кода показано, как создавать локализованную (Испанский — Испания) версию существующей классификации сообщений.

В третьем примере показано, как создавать другую локализованную версию (Испанский — Мексика) существующей классификации сообщений.

Копировать код
New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "Espana Example " -SenderDescription "Este es el texto de la descripcion"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "Mexico Example" -SenderDescription "Este es el texto de la descripcion"