Поделиться через


Командлет New-MessageClassification (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-08

С помощью командлета 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>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>]

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

Подробное описание

Для выполнения командлета New-MessageClassification используемой учетной записи необходимо делегировать следующие роли:

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

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

Параметры

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

DisplayName

Обязательность

System.String

Используйте параметр DisplayName, чтобы указать краткое имя для экземпляра классификации сообщений. Краткое имя отображается в Office 2007 и используется пользователями Outlook для выбора соответствующей классификации сообщений перед отправкой сообщения.

noteПримечание.
XML-файл классификации сообщений должен находиться на компьютере отправителя, чтобы отображалось краткое имя.

Если значение параметра UserDisplayEnabled равно $true, отображается краткое имя получателя, даже если нет установленного XML-файла классификации сообщений.

Когда указывается имя, которое включает пробелы, необходимо заключить его целиком в кавычки, например: "Display Name". Параметр DisplayName должен содержать не более 64 символов.

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

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

Locale

Обязательность

System.Globalization.CultureInfo

Указание кода культурной среды в параметре Locale создает локализованную версию классификации сообщений. Необходимо также передать параметр Identity существующей классификации сообщений по умолчанию при создании новой локализованной версии.

Допустимыми значениями параметра Locale являются строковые имена, отображаемые в столбце Имя культурной среды в справке по классам библиотеки классов Microsoft .NET, доступной на веб-странице, посвященной сведениям о культурных средах.

Имя

Обязательность

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 на одном предприятии.

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.

Пример

Следующий код содержит три примера использования командлета 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"