共用方式為

New-SystemMessage (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-08

使用 Microsoft Exchange Server 2007 中的 New-SystemMessage 指令程式可在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上以指定的語言建立新的自訂傳遞狀態通知 (DSN) 或配額郵件。

語法

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

詳細描述

此指令程式可讓您建立新的自訂 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 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange 組織系統管理員角色

若要在已安裝 Edge Transport server role 的電腦上執行 New-SystemMessage 指令程式，則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Exchange Server 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    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 quota and prohibit receive quota exceeds the specified mailbox send and receive size limit.

note附註：
若指定了 DsnCode 參數，則此參數不需要且無法使用。

Text

必要

System.String

此參數指定對寄件者或信箱擁有者顯示的訊息文字。文字應說明訊息建立的原因，以及寄件者或信箱擁有者應採取的動作 (若有的話)。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 Active Directory 應用程式模式 (ADAM) 執行個體。

TemplateInstance

選用

System.Management.Automation.PSObject

提供現有物件給此參數時，命令會使用該物件組態，在本機或目標伺服器上建立重複物件。

輸入類型

傳回類型

錯誤

錯誤 描述

例外狀況

例外狀況 描述

範例

在下列範例程式碼中，第一個範例會新增 DNS 代碼為 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."