通过

Get-CalendarDiagnosticObjects

模块:
Exchange PowerShell

此 cmdlet 仅在基于云的服务中可用。

使用 Get-CalendarDiagnosticObjects cmdlet 收集一系列日历日志。 日历诊断日志跟踪每个邮箱的重要日历相关事件数据，并可用于排查邮箱中发生的日历问题。 此日志跟踪所有的日历项目和会议邮件。

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

语法

Default （默认值） 

Get-CalendarDiagnosticObjects
    [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
    [-AnalyzeExceptionWithOriginalStartDate <ExDateTime>]
    [-AutoRequeryOnMeetingId <Boolean>]
    [-ConfigurationName <String>]
    [-CustomPropertyNames <String[]>]
    [-EndDate <ExDateTime>]
    [-EntryId <String>]
    [-EwsId <String>]
    [-ExactMatch <Boolean>]
    [-ItemClass <String[]>]
    [-ItemIds <String[]>]
    [-MaxResults <Int32>]
    [-MeetingId <String>]
    [-ODataId <String>]
    [-ResultSize <Unlimited>]
    [-ShouldBindToItem <Boolean>]
    [-ShouldDecodeEnums <Boolean>]
    [-ShouldFetchAttendeeCollection <Boolean>]
    [-ShouldFetchRecurrenceExceptions <Boolean>]
    [-ShouldResolveParticipants <Boolean>]
    [-StartDate <ExDateTime>]
    [-Subject <String>]
    [<CommonParameters>]

说明

结果中返回的一些更有趣的属性包括：

  • AppointmentState：1 = 约会是会议，2 = 已收到约会，4 = 约会被取消，8 = 约会是转发的约会。
  • CalendarLogTriggerAction：对 (项执行的作，例如创建或更新) 。
  • ClientInfoString： (进行更改的实体，例如 、Client=OWA;<AdditionalDetails>Client=WebServices;<AdditionalDetails>、 或 Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;) 。
  • MeetingRequestType：1 = 会议消息是会议请求，65536 = 会议消息是现有会议的完整更新，131072 = 会议消息是现有会议的信息性更新，262144 = 会议消息是无提示更新，524288 = 更新已过时，或1048576 = 会议消息转发给代理人， 且副本标记为信息性。
  • OriginalLastModifiedTime：用作对事件进行排序的主要排序字段。
  • ResponseType：0 = 组织者未收到响应，1 = 组织者会议副本，2 = 暂定，3 = 接受，4 = 拒绝，或 5 = 与会者未响应。
  • ResponsibleUserName：例如， (进行更改的用户的 LegacyExchangeDN 值， /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant 或 /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin) 。

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

本示例从佩德罗·皮扎罗的邮箱中检索主题与团队会议完全匹配的所有项目的日历诊断日志。

示例 2

$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoString

这与前面的示例相同，但现在结果按原始上次修改时间排序。

示例 3

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49

本示例检索具有指定唯一全局对象 ID 的会议（ (GOID) ）的佩德罗·皮扎罗邮箱的日历诊断日志。

示例 4

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformation

本示例返回在 2018 年 7 月修改的佩德罗 Pizarro 邮箱中主题团队午餐的会议的诊断信息，并将结果导出到文件 C：\My Documents\Team Lunch Meeting.csv。

参数

-AnalyzeExceptionWithOriginalStartDate

适用：Exchange Online

{{ Fill AnalyzeExceptionWithOriginalStartDate Description }}

参数属性

类型:ExDateTime
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AutoRequeryOnMeetingId

适用：Exchange Online

{{ Fill AutoRequeryOnMeetingId Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ConfigurationName

适用：Exchange Online

{{ Fill ConfigurationName Description }}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-CustomPropertyNames

适用：Exchange Online

CustomPropertyNames 参数在结果中返回指定的日历项自定义属性。 有关有效值，请参阅 Exchange Online PowerShell 中 CustomPropertyNames 参数的值。

可以指定用逗号分隔的多个值。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-EndDate

适用：Exchange Online

EndDate 参数指定上次修改会议时 OriginalLastModifiedTime 属性的日期范围的结束日期 (，而不是) 创建。

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

参数属性

类型:ExDateTime
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-EntryId

适用：Exchange Online

EntryID 参数按指定的 EntryID 属性值筛选结果，该值对应于PR_ENTRYID MAPI 属性。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-EwsId

适用：Exchange Online

{{ Fill EwsId Description }}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExactMatch

适用：Exchange Online

ExactMatch 参数指定为 Subject 参数指定的文本值是使用完全匹配还是部分匹配。 有效值包含:

  • $true：主题搜索使用完全匹配并搜索邮箱中的所有日历项目。 例如，如果搜索“预算”，则搜索将查找主题中任意位置包含“预算”的项目，但不会查找“预算”。
  • $false：主题搜索使用部分匹配，最多搜索邮箱中的 1000 个日历项目。 例如，如果搜索“预算”，则搜索将在主题中的任何位置查找具有“预算”和“预算”的项目。 此值为默认值。

部分主题匹配搜索可能不会返回所有相关日历项。 尝试使用完全匹配的主题搜索来获得更准确的结果。

仅将此参数与 Subject 参数一起使用。

使用 MeetingId 参数时，将忽略此参数的值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：Exchange Online

Identity 参数指定要查看其日历的邮箱或Microsoft 365 组。 可以使用唯一标识邮箱或 Microsoft 365 组的任何值。 例如：

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

参数属性

类型:UnifiedGroupOrUserMailboxIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ItemClass

适用：Exchange Online

ItemClass 参数按日历项的指定 MessageClass 属性值筛选结果， (例如 IPM。约会) 。 可以指定用逗号分隔的多个值。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ItemIds

适用：Exchange Online

ItemIds 参数按项 ID 筛选结果。 可以指定用逗号分隔的多个值。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MaxResults

适用：Exchange Online

{{ Fill MaxResults Description }}

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MeetingId

适用：Exchange Online

MeetingId 参数按日历项的全局唯一标识符筛选结果。 该值是此 cmdlet 的输出中提供的日历项的 CleanGlobalObjectId 属性，或者通过使用其他 MAPI 检查工具。 示例值040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55。 此值在日历项的整个生存期内保持不变。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ODataId

适用：Exchange Online

{{ Fill ODataId Description }}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResultSize

适用：Exchange Online

此参数确定 cmdlet 返回的结果数。 最大值为 1000。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShouldBindToItem

适用：Exchange Online

ShouldBindToItem 参数指定是否截断大型可流式处理属性值 (例如 AppointmentRecurrenceBlob) 。 有效值包含:

  • $true：大型可流属性的值不会截断，因此返回完整值。
  • $false：截断大型可流属性的值。 此值为默认值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShouldDecodeEnums

适用：Exchange Online

{{ Fill ShouldDecodeEnums Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShouldFetchAttendeeCollection

适用：Exchange Online

{{ Fill ShouldFetchAttendeeCollection Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShouldFetchRecurrenceExceptions

适用：Exchange Online

ShouldFetchRecurrenceExceptions 参数指定是否包括定期会议的异常。 有效值包含:

  • $true：包括定期会议的例外情况。 使用此值时，还需要使用 ItemIds 参数。
  • $false：不要对定期会议包括例外。 此值为默认值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShouldResolveParticipants

适用：Exchange Online

{{ Fill ShouldResolveParticipants Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-StartDate

适用：Exchange Online

StartDate 参数指定上次修改会议时 OriginalLastModifiedTime 属性 (的日期范围的开始日期，而不是) 。

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

参数属性

类型:ExDateTime
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Subject

适用：Exchange Online

Subject 参数通过 Subject 字段中的指定文本标识日历项。 指定的文本值不区分大小写。 如果值包含空格，则使用引号括住该值。 可以使用 ExactMatch 参数控制是否使用完全匹配

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。