Get-SystemMessage

模組:
Exchange PowerShell

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

使用 Get-SystemMessage Cmdlet 來檢視預設或自訂系統訊息。 系統訊息是傳遞狀態通知 (也稱為 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

您無法將此參數與 Original 參數搭配使用。

系統訊息的識別值使用下列其中一種格式：

  • 增強狀態碼的系統訊息： 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 限制。
  • 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 限制。
  • WarningMailboxMessagesPerFolderCount：信箱已設定 MailboxMessagesPerFolderCountReceiveQuota 限制時超過其 MailboxMessagesPerFolderCountWarningQuota 限制。

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

  • 一個信箱資料夾的子資料夾數目上限：
  • WarningFolderHierarchyChildrenCount：設定了 FolderHierarchyChildrenCountReceiveQuota 限制時，信箱超過其 FolderHierarchyChildrenCountWarningQuota 限制。
  • WarningFolderHierarchyChildrenCount：信箱已設定 FolderHierarchyChildrenCountReceiveQuota 限制時超過其 FolderHierarchyChildrenCountWarningQuota 限制。
  • ProhibitReceiveFoldersCount：信箱超過其 FoldersCountReceiveQuota 限制。
  • WarningFoldersCount： 信箱設定了 FoldersCountReceiveQuota 限制時，超過了其 FoldersCountWarningQuota 限制。
  • WarningFoldersCountUnlimited 信箱未設定 FoldersCountReceiveQuota 限制時，超過其 FoldersCountWarningQuota 限制。

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

  • 一個信箱資料夾的層級 (深度) 數目上限：
  • WarningFolderHierarchyDepth： 當信箱設定了 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 隨附的預設系統訊息來篩選結果。 您不需要使用此參數指定值。

您無法將此參數與 Identity 參數搭配使用。

參數屬性

類型: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

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