Set-SystemMessage (RTM)
适用于: Exchange Server 2007
上一次修改主题: 2007-06-08
在 Microsoft Exchange Server 2007 中使用 Set-SystemMessage cmdlet,可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上,以指定语言修改现有的自定义发送状态通知 (DSN) 或配额邮件。
语法
Set-SystemMessage -Identity <SystemMessageIdParameter> [-DomainController <Fqdn>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>]
Set-SystemMessage [-DomainController <Fqdn>] [-Instance <SystemMessage>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>]
详细说明
此 cmdlet 用于修改自定义 DSN 和配额邮件。DSN 邮件发送给没有到达指定收件人的电子邮件的发件人。配额邮件发送给其邮箱或公用文件夹已达到特定警告配额、禁止发送配额或禁止接收配额的用户。自定义的 DSN 邮件和配额邮件将替换 Exchange Server 附带的内置 DSN 邮件或配额邮件。
注意 Exchange 服务器是用几个标准 DSN 邮件预配置的,无法使用此 cmdlet 修改这些标准 DSN 邮件。而必须用相同 DSN 代码新建 DSN 邮件,才能替换预配置的邮件。
下表描述了触发其传递状态为持续性临时失败和持久性失败的 DSN 邮件的错误条件。
4.X.X. DSN 邮件 此类型的 DSN 邮件是在收件人的邮箱或服务器临时出现问题时生成的。这样的问题最后通常会自行解决,并允许成功传递电子邮件。4.X.X. 持续性临时失败问题的示例是已脱机并且无法进行访问的服务器。
5.X.X. DSN 邮件 此类型的 DSN 邮件是在收件人的邮箱或服务器发生持久性或致命错误时生成的。这样的错误无法由发送邮件的服务器解决,因此,电子邮件将返回到发件人。5.X.X. 持久性失败错误的示例是不存在的 SMTP 地址。
若要运行 Set-SystemMessage cmdlet,必须为您使用的帐户委派以下角色:
- Exchange 组织管理员角色
若要在安装了边缘传输服务器角色的计算机上运行 Set-SystemMessage cmdlet,必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter |
此参数指定要修改的 DSN 或配额邮件的标识。 若要修改 DSN 邮件,请使用以下格式:language\internal | external\system code。有关 DSN 邮件标识的语法的详细信息,请参阅 DSN 邮件标识。 若要修改自定义配额邮件,请使用以下格式:language\QuotaMessageType。Language 的表达形式为两字符的区域设置代码。QuotaMessageType 参数接受下列值:
可以省略 Identity 参数标签。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定将数据写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入和读取本地 Active Directory 应用程序模式 (ADAM) 实例。 |
Instance |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.SystemMessage |
使用此参数,可以将 DSN 或配额邮件传递给该命令进行处理。此参数用于必须将整个对象传递给该命令。 |
Name |
可选 |
System.String |
此参数指定可以用于描述 DSN 或配额邮件的名称。 |
Original |
可选 |
System.Management.Automation.SwitchParameter |
此参数将 DSN 邮件或配额邮件文本还原为原始的传输文本。如果不希望删除自定义 DSN 或配额输入但是希望还原为原始文本,则可以使用此参数。 |
Text |
可选 |
System.String |
此参数指定向发件人或邮箱所有者显示的邮件文本。该文本解释创建邮件的原因以及发件人或邮箱所有者应执行什么操作(如果有)。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
异常
异常 | 说明 |
---|---|
示例
在以下示例代码中,第一个示例修改具有 DSN 代码 5.3.5 的现有自定义 DSN 邮件的英文文本。此 DSN 邮件只对外部用户显示。DSN 邮件的文本包括在命令行中。
第二个示例修改现有自定义 WarningMailbox
配额邮件的英文文本。
Set-SystemMessage En\Internal\5.3.5 -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."