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

Синтаксис


New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true \| $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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


New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize \| WarningPublicFolderUnlimitedSize \| WarningMailbox \| WarningPublicFolder \| ProhibitSendMailbox \| ProhibitPostPublicFolder \| ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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

Параметры

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

DsnCode

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

Microsoft.Exchange.Data.EnhancedStatusCode

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

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

Internal

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

System.Boolean

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

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

Language

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

System.Globalization.CultureInfo

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

QuotaMessageType

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType

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

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

WarningMailboxUnlimitedSize. Выдается, когда почтовый ящик, для которого не задана ни квота запрещения отправки, ни квота запрещения получения, превышает заданный предел предупреждения для почтового ящика.
WarningPublicFolderUnlimitedSize Выдается, когда почтовый ящик, для которого не задана ни квота запрещения отправки, ни квота запрещения получения, превышает заданный предел предупреждения для общей папки.
WarningMailbox Выдается, когда размер почтового ящика, для которого задана квота запрещения отправки или квота запрещения получения, превышает заданный предел предупреждения для почтового ящика.
WarningPublicFolder Выдается, когда почтовый ящик, для которого задана квота запрещения отправки или квота запрещения получения, превышает заданный предел предупреждения для общей папки.
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.

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

Text

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

System.String

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

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

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

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

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

Ошибки

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

Исключения

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

Пример

В следующих примерах кода первый пример добавляет новое настраиваемое уведомление о состоянии доставки с кодом 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."

Копировать код

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."