Get-Notification

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

注意

此 cmdlet 将在基于云的服务中弃用。 经典 Exchange 管理中心于 2023 年在基于云的服务中弃用。

使用 Get-Notification cmdlet 查看在 Exchange 管理中心的通知查看器中显示的通知事件 (EAC) 。 这些通知与以下事件相关:

  • 邮箱移动和迁移。
  • 即将过期和已过期的证书。
  • 将邮箱内容导出到 .pst 文件中。
  • 从 .pst 文件导入邮箱内容。
  • 还原已删除的邮箱。

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

语法

Get-Notification
   [-Settings]
   -ProcessType <AsyncOperationType>
   [-DomainController <Fqdn>]
   [<CommonParameters>]
Get-Notification
   [[-Identity] <EwsStoreObjectIdParameter>]
   [-Summary]
   [-DomainController <Fqdn>]
   [<CommonParameters>]
Get-Notification
   [-ProcessType <AsyncOperationType>]
   [-ResultSize <Unlimited>]
   [-StartDate <ExDateTime>]
   [-Summary]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-Notification

此示例显示所有通知事件的摘要列表。

示例 2

Get-Notification -ProcessType Migration

此示例显示所有邮箱移动和迁移通知事件的摘要列表。

示例 3

Get-Notification -Identity 0259ec74-3539-4195-ab4f-de93e654ceaf | Format-List

此示例显示指定通知事件的详细信息。

参数

-DomainController

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

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

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Identity 参数指定要查看的通知事件。 可以通过 GUID) (AlternativeID 属性值来标识通知事件。 可以通过运行 命令来查找此值 Get-Notification |Format-List DisplayName,AlternateID,StartTime,Status,Type。

类型:EwsStoreObjectIdParameter
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ProcessType

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ProcessType 参数按通知事件的类型筛选结果。 有效值包含:

  • CertExpiry
  • ExportPST
  • ImportPST
  • MailboxRestore
  • 迁移
类型:AsyncOperationType
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ResultSize

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。

类型:Unlimited
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Settings

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

“设置”开关在结果中包含 ProcessType 和 NotificationEmail 属性值。 不必为此开关指定值。

只能将此开关与 ProcessType 参数值 CertExpiry 一起使用。

不能将此开关与“摘要”开关一起使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-StartDate

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

StartDate 参数指定日期范围的起始日期。

请使用短日期格式,该格式在运行命令的计算机上的“区域选项”设置中定义。 例如,如果计算机配置为使用短日期格式 MM/dd/yyyy,请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期,也可以输入当天的日期和时间。 如果输入当天的日期和时间,请将该值括在引号 (") 中,例如,"09/01/2018 5:00 PM"。

类型:ExDateTime
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Summary

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

“摘要”开关在结果中仅包括 ProcessType 和 Status 属性值。 不必为此开关指定值。

不能将此开关与“设置”开关一起使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

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

输出

Output types

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