New-SystemMessage

語法

Dsn

New-SystemMessage
    -DsnCode <EnhancedStatusCode>
    -Internal <Boolean>
    -Language <CultureInfo>
    -Text <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Quota

New-SystemMessage
    -Language <CultureInfo>
    -QuotaMessageType <QuotaMessageType>
    -Text <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Description

範例

範例 1

New-SystemMessage -DsnCode 5.3.5 -Language en -Internal $false -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."

範例 2

New-SystemMessage -QuotaMessageType WarningMailbox -Language en -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

參數

-Confirm

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

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

• 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
• 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。

參數屬性

參數集

-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) 的本機執行個體來讀寫資料。

參數屬性

參數集

-DsnCode

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

DsnCode 參數會指定自訂系統訊息的增強狀態碼。

有效值為 4.x.y 或 5.x.y，其中 x 和 y 是一到三位數的數字。 您可以指定隨附於 Exchange 的預設代碼，也可以指定自訂代碼。

若要產生 Exchange 使用的預設增強狀態碼清單，請執行此命令： Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html"。

您必須將此參數與 [語言] 和 [內部] 參數搭配使用。

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

參數屬性

參數集

-Internal

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

Internal 參數會指定要向內部或外部使用者顯示系統訊息。 有效值為：

• $true：向內部寄件者顯示 NDR。
• $false：向外部寄件者顯示 NDR。

您必須將此參數與 DsnCode 和語言參數搭配使用。

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

參數屬性

參數集

-Language

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

Language 參數可指定訊息的語言 (例如，en 代表英文，ja 代表日文) 。 如需支援的語言代碼清單，請參閱 NDR 支援的語言。

您必須將此參數與 DsnCode 或 QuotaMessageType 參數搭配使用。

參數屬性

參數集

-QuotaMessageType

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

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 限制。

您必須將此參數與 Language 參數搭配使用。

您無法將此參數與 DsnCode 或 Internal 參數搭配使用。

參數屬性

參數集

-Text

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

Text 參數會指定自訂系統訊息中的文字。 文字應說明傳送系統訊息的原因，以及使用者應採取的任何動作。

您必須將此參數與 DsnCode 或 QuotaMessageType 參數搭配使用。

此參數可以包含文字和 HTML 標籤。 最大長度為 512 個字元 (其中包含) 的所有文字和 HTML 標籤。

下列 HTML 標籤可供使用：

• <B> 和 </B> (粗)
• <EM> 和 </EM> (斜體)
• <BR> (分行符號)
• <P> 和 </P> (段落)
• <A HREF="url"> 和 </A> (超連結) 。 注意：如果您使用此標籤，則需要使用單引號 (而不是雙引) 號括住完整文字字串。 否則，您會因為標籤) 中的雙引號而收到錯誤 (。

對這些特殊字元使用下列逸出碼：

• < 針對 <
• > 針對 >
• " 對於”
• & &

以下是使用 HTML 標籤和特殊字元的此參數範例值：

'You tried to send a message to a <B>disabled</B> mailbox. Please visit <A HREF="https://it.contoso.com">Internal Support</A> or contact &quot;InfoSec&quot; for more information.'

參數屬性

參數集

-WhatIf

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

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

參數集

CommonParameters

輸入

Input types

輸出

Output types