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


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

 

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

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

Командлет New-SystemMessage используется в Microsoft Exchange Server 2007 для создания новых настраиваемых уведомлений о состоянии доставки или сообщений квоты, используя указанный язык, на компьютерах с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.

Синтаксис

New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-DomainController <Fqdn>] [-TemplateInstance <PSObject>]

New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-DomainController <Fqdn>] [-TemplateInstance <PSObject>]

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

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

В следующем списке описываются условия ошибки, запускающие DNS-сообщения, состояние доставки которых указывает на наличие повторяющейся временной ошибки или на наличие постоянной ошибки.

  • DSN-сообщения 4.X.X. Этот тип DSN-сообщений создается, когда существует временная неполадка на почтовом ящике или сервере получателя. Обычно такие неполадки устраняются со временем сами по себе, и сообщение успешно доставляется. Примером временной повторяющейся ошибки 4.X.X является ситуация, когда сервер отключен и недоступен.

  • **DSN-сообщения 5.X.X.**Этот тип DSN-сообщения создается в случае постоянной или неустранимой ошибки почтового ящика или сервера получателя. Такие ошибки не могут быть устранены отправляющим почтовым сервером, поэтому сообщения электронной почты возвращаются отправителю. Примером постоянной ошибки отправки 5.X.X является несуществующий SMTP-адрес.

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

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

Чтобы выполнить командлет New-SystemMessage на компьютере с установленной ролью сервера граничного транспорта, необходимо войти в систему с помощью учетной записи, входящей в локальную группу администраторов на этом компьютере.

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

Параметры

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

DsnCode

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

Microsoft.Exchange.Data.EnhancedStatusCode

Этот параметр определяет, к какому коду уведомления о состоянии доставки применяется сообщение уведомления о состоянии доставки. Этот параметр может быть встроенным кодом или настраиваемым кодом, определенным администратором.

noteПримечание.
Этот параметр не является обязательным и не может быть использован, если задан параметр QuotaMessageType.

Internal

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

System.Boolean

Этот параметр определяет, будет ли сообщение выводиться для пользователей, находящихся внутри организации Exchange Server. Для сообщений, которые будут отображаться только внутри организации, введите $true. Для сообщений, которые будут отображаться только для внешних пользователей, введите $false.

noteПримечание.
Этот параметр не является обязательным и не может быть использован, если задан параметр QuotaMessageType.

Язык

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

System.Globalization.CultureInfo

Этот параметр определяет язык сообщения. Это сообщение может быть создано с использованием любого языка, поддерживаемого Exchange Server. Языки задаются с помощью соответствующего обозначения. Например, английский обозначается как «en». Японский — как «ja». Полный список обозначений языков приведен в разделе Поддерживаемые языки для системных сообщений.

QuotaMessageType

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType

Этот параметр выбирает тип создаваемого сообщения квоты.

У параметра QuotaMessageType могут быть следующие значения:

  • WarningMailboxUnlimitedSize. Выдается, когда почтовый ящик, для которого не задана ни квота запрещения отправки, ни квота запрещения получения, превышает заданный предел предупреждения для почтового ящика.

  • WarningPublicFolderUnlimitedSize    Issued when a public folder без квоты запрета отправки или квоты запрета получения превышает указанное ограничение общей папки, при котором создается предупреждение.

  • WarningMailbox    Выдается, когда размер почтового ящика, для которого задана квота запрещения отправки или квота запрещения получения, превышает заданный предел предупреждения для почтового ящика.

  • WarningPublicFolder    Issued when a public folder с квотой запрета отправки или квотой запрета получения превышает указанное ограничение общей папки, при котором создается предупреждение.

  • ProhibitSendMailbox    Issued when a mailbox that has a prohibit send квота exceeds the specified mailbox size limit.

  • ProhibitPostPublicFolder    Issued when a public folder that has a prohibit send квота exceeds the specified public folder size limit.

  • ProhibitSendReceiveMailBox    Issued when a mailbox that has prohibit send квота and prohibit receive квота exceeds the specified mailbox send and receive size limit.

noteПримечание.
Этот параметр не является обязательным и не может быть использован, если задан параметр DsnCode.

Text

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

System.String

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

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

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

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

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

Исключения

Исключения Описание

Пример

В следующих примерах кода первый пример добавляет новое настраиваемое уведомление о состоянии доставки с кодом 5.3.5. Соответствующее сообщение уведомления о состоянии доставки будет выводиться только для внешних пользователей. Текст уведомления о состоянии доставки введен в командной строке вместе с языком сообщения, английским.

Второй пример добавляет новое настраиваемое сообщение квоты WarningMailbox. Это сообщение выводится для пользователей, соответствующим следующим условиям:

  • Почтовый ящик превысил предел предупреждения почтового ящика, заданный для почтового ящика.

  • Квота запрещения отправки или запрещения приема для почтового ящика отсутствует.

  • Этот почтовый ящик находится на сервере, использующем английские язык и стандарты.

New-SystemMessage -DsnCode 5.3.5 -Language En -Internal $false  -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
New-SystemMessage -QuotaMessageType WarningMailbox -Language En -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."