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


Set-MessageClassification

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

Используйте командлет Set-MessageClassification, чтобы настроить существующий экземпляр классификации сообщений в организации Exchange.

Синтаксис

Set-MessageClassification -Identity <MessageClassificationIdParameter> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-MessageClassification [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Instance <MessageClassification>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

Параметры

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

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

Параметр Identity может принимать строковое значение, которое является значением Name или идентификатором GUID.

ClassificationID

Необязательный

System.Guid

Используйте этот параметр, чтобы указать идентификатор GUID существующей классификации сообщений, которую необходимо использовать в организации Exchange. Используйте этот параметр при настройке классификации сообщений, чтобы охватить два леса Exchange в одной организации.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

DisplayName

Необязательный

System.String

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

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

DisplayPrecedence

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClassificationDisplayPrecedenceLevel

Используйте этот параметр, чтобы указать относительный приоритет данной классификации сообщений по отношению к другим классификациям сообщений, которые могут быть применены к данному сообщению. Несмотря на то, что Outlook позволяет пользователю указывать только одну классификацию для определенного сообщения, с помощью правила транспорта можно применить и другие классификации. Этот параметр задает приоритет для данной классификации сообщений, с которой она выводится для получателя в Outlook. Сначала отображается классификация с наивысшим приоритетом, а последующие классификации, для которых этим параметром определен более низкий приоритет, добавляются в соответствующем порядке.

Допустимыми входными значениями параметра DisplayPrecedence могут быть Highest, Higher, High, MediumHigh, Medium, MediumLow, Low, Lower и Lowest.

Значение по умолчанию: Mediuum.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, нужно включить в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах, на которых установлена роль пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет запись только на локальный экземпляр ADAM (Active Directory Application Mode).

Instance

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.MessageClassification

Используйте этот параметр, чтобы передать в команду для обработки весь объект. Этот параметр главным образом используется в сценариях, в которых команде должен быть передан весь объект.

Name

Необязательный

System.String

Используйте этот параметр, чтобы указать административное имя для экземпляра классификации сообщений. Это имя используется для управления экземпляром классификации сообщений. Когда указывается имя, которое включает пробелы, необходимо заключить его целиком в кавычки, например: "Adminstrative Name". Параметр Name должен содержать не более 256 символов.

RecipientDescription

Необязательный

System.String

Используйте этот параметр, чтобы объяснить получателю, для чего была предназначена классификация сообщения. Введенный в этот параметр текст может просматриваться пользователями Outlook при получении сообщения с этой классификацией. Заключите описание в кавычки, как в следующем примере: "This is the recipient description that explains how to treat the message that has been classified". Параметр RecipientDescription должен содержать не более 1024 символов.

Если не будет введено значение для этого параметра, будет использоваться описание, веденное для параметра SenderDescription.

RetainClassificationEnabled

Необязательный

System.Boolean

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

Значение по умолчанию: $true.

SenderDescription

Необязательный

System.String

Используйте этот параметр, чтобы объяснить получателю, для чего была предназначена классификация сообщения. Текст, введенный в этот параметр, используется пользователями Outlook для выбора соответствующей классификации сообщений перед отправкой сообщения. Заключите описание в кавычки, например: "This is the sender description that explains when to use this message classification". Параметр SenderDescription должен содержать не более 1024 символов.

UserDisplayEnabled

Необязательный

System.Boolean

Когда для параметра UserDisplayEnabled задано значение $true, выводится текст, введенный в параметры DisplayName и RecipientDescription, для получателей сообщений, отправленных с этой классификацией сообщений.

Значение по умолчанию: $true.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

Пример

В следующем примере кода для экземпляра классификации сообщения с параметром Identity из «Примера» в качестве значения действия конфиденциальности задается «None», а в качестве приоритета вывода — «false». Также в нем указывается, что классификация сообщений не должна оставаться присвоенной сообщению, если сообщение будет переслано или на него будет отправлен ответ.

Set-MessageClassification -Identity Example -ConfidentialityAction None -DisplayPrecedence -RetainClassificationEnabled: $false