Get-SystemMessage
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-SystemMessage Cmdlet 來檢視預設或自訂系統訊息。 系統訊息是傳遞狀態通知 (也稱為 DSN、非傳遞報告、DDR 或退回的訊息) 和配額訊息。
如需下方<語法>一節中參數集的詳細資訊,請參閱 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
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
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 限制。
- 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 限制。
參數屬性
| 類型: | 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 隨附的預設系統訊息來篩選結果。 您不需要使用此參數指定值。
您無法搭配 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。