共用方式為

Get-SystemMessage

模組:
Exchange PowerShell

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-SystemMessage 指令碼來查看預設或自訂系統訊息。 系統訊息是傳遞狀態通知 (也稱為DSN、未交付報告、NDR或退信訊息) 與配額訊息。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Identity 

Get-SystemMessage
    [[-Identity] <SystemMessageIdParameter>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Original 

Get-SystemMessage
    [-Original]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Description

NDR 是發給尚未送達預期收件人的電子郵件寄件人。 會針對其信箱或公用資料夾已達特定警告、禁止傳送或禁止接收配額的使用者，發出配額郵件。 自訂的 NDR 與配額訊息會取代 Exchange 內建的預設訊息。

您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-SystemMessage

此範例顯示組織中所有自訂系統訊息的摘要清單。

範例 2

Get-SystemMessage En\Internal\5.3.2 | Format-List

此範例顯示指定自訂 NDR 的詳細資訊， (語言、受眾及增強狀態碼值的組合) 。

範例 3

Get-SystemMessage En\WarningMailbox | Format-List

此範例 (語言與配額值) 組合，顯示指定自訂配額訊息的詳細資訊。

範例 4

Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default System Messages.html"

此範例將所有預設系統訊息的列表以所有語言輸出到一個名為 C：\My Documents\Default System Messages.html 的 HTML 檔案。

你應該把清單輸出成檔案，因為清單很長，如果沒安裝必要的語言包會出錯。

參數

-DomainController

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 參數指定你想查看的自訂系統訊息。 你可以使用任何能唯一識別系統訊息的值。 例如：

  • 身分識別
  • 辨別名稱 (DN)
  • GUID

你無法用這個參數來搭配原始交換器。

系統訊息的身份值使用以下格式之一：

  • 系統訊息用於強化狀態碼： Language\<Internal | External>\DSNCode。 例如，En\Internal\5.1.2 或 Ja\External\5.1.2。
  • 配額系統訊息： Language\QuotaMessageType。 例如，En\ProhibitSendReceiveMailbox。

<語言>：關於支援的語言代碼列表，請參見 NDR 支援語言。

<DSNCode>：有效值為 4.x.y 或 5.x.y，其中 x 和 y 為一至三位數。 要查看目前由自訂系統訊息使用的增強系統代碼，請執行指令 Get-SystemMessage。 要產生 Exchange 使用的預設增強狀態碼清單，請執行此指令： Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html"。

<QuotaMessageType>： 有效值為：

您可以使用 and 比較運算子來指定多個準則。不是以整數表示的內容值必須用引號 (") 括住。

  • 禁止發送收件信箱：信箱超過其禁止寄收配額上限。
  • ProhibitSendReceiveMailBox：信箱會超過其 ProhibitSendReceiveQuota 限制。
  • WarningMailbox：當信箱設定了 ProhibitSendQuota 或 ProhibitSendReceiveQuota 限制時，該信箱超過其 IssueWarningQuota 限制。
  • WarningMailbox：信箱已設定 ProhibitSendQuota 或 ProhibitSendReceiveQuota 限制時超過其 IssueWarningQuota 限制。

WarningMailboxUnlimitedSize：信箱未設定 ProhibitSendQuota 或 ProhibitSendReceiveQuota 限制時超過其 IssueWarningQuota 限制。

  • 公用資料夾大小配額：
  • WarningPublicFolder：當一個公共資料夾設定了 ProhibitPostQuota 限制時，該資料夾會超過其 IssueWarningQuota 限制。
  • WarningPublicFolder：公用資料夾已設定其 ProhibitPostQuota 限制時超過其 IssueWarningQuota 限制。

WarningPublicFolderUnlimitedSize：公用資料夾未設定其 ProhibitPostQuota 限制時超過其 IssueWarningQuota 限制。

  • 一個信箱資料夾的郵件數目上限：
  • 警告郵件匣每個資料夾數量：當信箱設定了郵件箱每個資料夾計數接收配額限制時，該信箱超過其郵件郵件每個資料夾計數警告配額上限。
  • WarningMailboxMessagesPerFolderCount：信箱已設定 MailboxMessagesPerFolderCountReceiveQuota 限制時超過其 MailboxMessagesPerFolderCountWarningQuota 限制。

WarningMailboxMessagesPerFolderUnlimitedCount：信箱未設定 MailboxMessagesPerFolderCountReceiveQuota 限制時超過其 MailboxMessagesPerFolderCountWarningQuota 限制。

  • 一個信箱資料夾的子資料夾數目上限：
  • 警告資料夾HierarchyChildrenCount：當信箱設定了資料夾階層ChildrenCountReceiveQuota限制時，該信箱超過其資料夾階層ChildrenCountAccessQuota限制。
  • WarningFolderHierarchyChildrenCount：信箱已設定 FolderHierarchyChildrenCountReceiveQuota 限制時超過其 FolderHierarchyChildrenCountWarningQuota 限制。
  • 禁止接收資料夾數量：信箱超過其資料夾數量接收配額上限。
  • WarningFoldersCount：當信箱設定了 FoldersCountReceiveQuota 限制時，該信箱超過其 FoldersCountWarningQuota 限制。
  • 警告資料夾數量無限 當信箱未設定資料夾數量接收配額限制時，該信箱超過其資料夾數量警告配額上限。

WarningFoldersCountUnlimited 信箱未設定 FoldersCountReceiveQuota 限制時超過其 FoldersCountWarningQuota 限制。

  • 一個信箱資料夾的層級 (深度) 數目上限：
  • 警告FolderHierarchyDepth：當一個郵箱設定了FolderHierarchyDepthReceiveQuota限制時，該信箱超過其FolderHierarchyDepthWarningQuota上限。
  • WarningFolderHierarchyDepth：信箱已設定 FolderHierarchyDepthReceiveQuota 限制時超過其 FolderHierarchyDepthWarningQuota 限制。

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

類型:SystemMessageIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Original

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

原始交換器會依據 Exchange 內建的預設系統訊息來過濾結果。 您不需要使用此參數指定值。

你不能用這個開關搭配身份參數。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Original
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。