Get-SystemMessage

此 cmdlet 仅适用于本地 Exchange。

使用 Get-SystemMessage cmdlet 查看默认或自定义系统消息。 系统消息是传递状态通知 (也称为 DSN、未送达报告、) 和配额消息的退回邮件。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

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

说明

向尚未到达预期收件人的电子邮件发件人发出NDR。 配额邮件发送给其邮箱或公用文件夹已到达特定警告、禁止发送或禁止接收配额的用户。 自定义NDR和配额消息将替换 Exchange 中包含的默认消息。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 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

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 参数指定要查看的自定义系统消息。 可以使用唯一标识系统消息的任何值。 例如:

  • 标识
  • 可分辨名称 (DN)
  • GUID

不能将此参数与原始开关一起使用。

系统消息的标识值使用以下格式之一:

  • 增强状态代码的系统消息: Language\<Internal | External>\DSNCode。 例如,En\Internal\5.1.2Ja\External\5.1.2
  • 配额的系统消息: Language\QuotaMessageType。 例如,En\ProhibitSendReceiveMailbox

<语言>:有关支持的语言代码列表,请参阅 DDR 支持的语言

<DSNCode>:有效值为 4.x.y 或 5.x.y,其中 x 和 y 是 1 到 3 位数。 若要查看自定义系统消息当前使用的增强系统代码,请运行 命令 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:邮箱超出了它的 IssueWarningQuota 限制(若已配置 ProhibitSendQuota 或 ProhibitSendReceiveQuota 限制的话)。

WarningMailboxUnlimitedSize:邮箱超出了它的 IssueWarningQuota 限制(若未配置 ProhibitSendQuota 或 ProhibitSendReceiveQuota 限制的话)。

  • 公用文件夹大小配额:
  • WarningPublicFolder:公用文件夹在配置了 ProhibitPostQuota 限制时超出其 IssueWarningQuota 限制。
  • WarningPublicFolder:公用文件夹超出了它的 IssueWarningQuota 限制(若已配置 ProhibitPostQuota 限制的话)。

WarningPublicFolderUnlimitedSize:公用文件夹超出了它的 IssueWarningQuota 限制(若未配置 ProhibitPostQuota 限制的话)。

  • 邮箱文件夹中的邮件数量上限:
  • WarningMailboxMessagesPerFolderCount:当邮箱配置了 MailboxMessagesPerFolderCountReceiveQuota 限制时,邮箱将超出其 MailboxMessagesPerFolderCountWarningQuota 限制。
  • WarningMailboxMessagesPerFolderCount:邮箱超出了它的 MailboxMessagesPerFolderCountWarningQuota 限制(若已配置 MailboxMessagesPerFolderCountReceiveQuota 限制的话)。

WarningMailboxMessagesPerFolderUnlimitedCount:邮箱超出了它的 MailboxMessagesPerFolderCountWarningQuota 限制(若未配置 MailboxMessagesPerFolderCountReceiveQuota 限制的话)。

  • 邮箱文件夹中的子文件夹数量上限:
  • WarningFolderHierarchyChildrenCount:当邮箱配置了 FolderHierarchyChildrenCountReceiveQuota 限制时,邮箱超出了其 FolderHierarchyChildrenCountWarningQuota 限制。
  • WarningFolderHierarchyChildrenCount:邮箱超出了它的 FolderHierarchyChildrenCountWarningQuota 限制(若已配置 FolderHierarchyChildrenCountReceiveQuota 限制的话)。
  • ProhibitReceiveFoldersCount:邮箱超出其 FoldersCountReceiveQuota 限制。
  • WarningFoldersCount:如果邮箱配置了 FoldersCountReceiveQuota 限制,则邮箱超出其 FoldersCountWarningQuota 限制。
  • WarningFoldersCountUnlimited 邮箱在未配置 FoldersCountReceiveQuota 限制时超出其 FoldersCountWarningQuota 限制。

WarningFoldersCountUnlimited:邮箱超出了它的 FoldersCountWarningQuota 限制(若未配置 FoldersCountReceiveQuota 限制的话)。

  • 邮箱文件夹中的级别(深度)数量上限:
  • WarningFolderHierarchyDepth:当邮箱配置了 FolderHierarchyDepthReceiveQuota 限制时,邮箱超出其 FolderHierarchyDepthWarningQuota 限制。
  • WarningFolderHierarchyDepth:邮箱超出了它的 FolderHierarchyDepthWarningQuota 限制(若已配置 FolderHierarchyDepthReceiveQuota 限制的话)。
Type:SystemMessageIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Original

原始开关按 Exchange 附带的默认系统消息筛选结果。 不必为此开关指定值。

不能将此开关与 Identity 参数一起使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。