New-MessageClassification
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-06-28
С помощью командлета 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>]]
Подробное описание
Для выполнения командлета New-MessageClassification используемой учетной записи необходимо делегировать следующие роли:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание | ||
|---|---|---|---|---|---|
DisplayName |
Обязательный |
System.String |
Используйте параметр DisplayName, чтобы указать краткое имя для экземпляра классификации сообщений. Краткое имя отображается в Office 2007 и используется пользователями Outlook для выбора соответствующей классификации сообщений перед отправкой сообщения.
Если значение параметра UserDisplayEnabled равно Когда указывается имя, которое включает пробелы, необходимо заключить его целиком в кавычки, например: |
||
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter |
Используйте этот параметр для создания локализованной версии существующей классификации сообщений. Необходимо задать параметр Locale. Параметр Identity может принимать строковое значение, которое является значением Name существующей классификации сообщений. |
||
Locale |
Обязательный |
System.Globalization.CultureInfo |
Указание кода культурной среды в параметре Locale создает локализованную версию классификации сообщений. Необходимо также передать параметр Identity существующей классификации сообщений по умолчанию при создании новой локализованной версии. Допустимыми значениями параметра Locale являются строковые имена, отображаемые в столбце Имя культурной среды в справке по классам библиотеки классов Microsoft .NET, доступной на веб-странице, посвященной сведениям о культурных средах. |
||
Name |
Обязательный |
System.String |
Используйте этот параметр, чтобы указать административное имя для экземпляра классификации сообщений. Это имя используется для управления экземпляром классификации сообщений. Когда указывается имя, которое включает пробелы, необходимо заключить его целиком в кавычки, например: |
||
SenderDescription |
Обязательный |
System.String |
Используйте этот параметр, чтобы объяснить получателю, для чего была предназначена классификация сообщения. Значение этого параметра используется пользователями Outlook для выбора соответствующей классификации сообщений перед отправкой сообщения. Заключите описание в кавычки, например: |
||
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 при получении сообщения с этой классификацией. Заключите описание в кавычки, например: Если не будет введено значение для этого параметра, будет использоваться описание, веденное для параметра SenderDescription. |
||
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда в качестве значения параметра TemplateInstance подставляется существующий объект, команда использует конфигурацию объекта для создания точной копии объекта на локальном или целевом сервере. |
||
UserDisplayEnabled |
Необязательный |
System.Boolean |
Используйте этот параметр для определения, должны ли значения параметров DisplayName и RecipientDescription отображаться в сообщении получателя Outlook. Если значение параметра UserDisplayEnabled равно Значение по умолчанию: |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется. |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
.gif "note")
Примечание.Пример
Следующий код содержит три примера использования командлета 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"