New-SystemMessage

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-07-27

使用 Microsoft Exchange Server 2007 中的 New-SystemMessage cmdlet，可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上以指定语言新建自定义发送状态通知 (DSN) 或配额邮件。

语法

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>]]

详细说明

此 cmdlet 用于新建自定义 DSN 和配额邮件。DSN 邮件发送给没有到达指定收件人的电子邮件的发件人。配额邮件发送给其邮箱或公用文件夹已到达特定警告、禁止发送或禁止接收配额的用户。自定义的 DSN 邮件和配额邮件将替换 Exchange Server 附带的内置 DSN 或配额邮件。

下表描述了触发其传递状态为持续性临时失败和持久性失败的 DSN 邮件的错误条件。

  • 4.X.X. DSN 邮件   此类型的 DSN 邮件是在收件人的邮箱或服务器临时出现问题时生成的。这样的问题最后通常会自行解决，并允许成功传递电子邮件。4.X.X. 持续性临时失败问题的示例是已脱机并且无法进行访问的服务器。

  • 5.X.X. DSN 邮件   此类型的 DSN 邮件是在收件人的邮箱或服务器发生持久性或致命错误时生成的。这样的错误无法由发送邮件的服务器解决，因此，电子邮件将返回到发件人。5.X.X. 持久性失败错误的示例是不存在的 SMTP 地址。

若要运行 New-SystemMessage cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 组织管理员角色

若要在安装了边缘传输服务器角色的计算机上运行 New-SystemMessage cmdlet，必须使用作为该计算机的本地 Administrators 组成员的帐户登录。

有关权限、角色委派以及管理 Exchange 2007 所需权限的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

DsnCode

必需

Microsoft.Exchange.Data.EnhancedStatusCode

此参数指定 DSN 邮件所应用的 DSN 代码。此参数可以是内置代码，也可以是管理员自定义的代码。

note注意：
此参数不是必需的，如果指定了 QuotaMessageType 参数，则不能使用它。

Internal

必需

System.Boolean

此参数指定是否向 Exchange Server 组织内部的用户显示邮件。对于只在内部显示的邮件，请输入 $true。对于只能向外部用户显示的邮件，请输入 $false。

note注意：
此参数不是必需的，如果指定了 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 当有禁止发送配额和禁止接收配额的邮箱超过指定邮箱发送和接收大小限制时发送。

note注意：
此参数不是必需的，如果指定了 DsnCode 参数，则不能使用它。

Text

必需

System.String

此参数指定向发件人或邮箱所有者显示的邮件文本。该文本解释创建邮件的原因以及发件人或邮箱所有者应执行什么操作（如果有）。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只对本地 Active Directory 应用程序模式 (ADAM) 实例执行写入和读取操作。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

在下面的示例代码中，第一个示例添加 DSN 代码为 5.3.5 的新的自定义 DSN 邮件。此 DSN 邮件只显示给外部用户。DSN 邮件的文本与邮件语言（英语）一起包含在命令行中。

第二个示例添加新的自定义 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."