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.2
或Ja\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 不返回任何数据。