Get-CalendarDiagnosticObjects

参考

模块:: ExchangePowerShell

适用于:: Exchange Online

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

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

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

语法

Get-CalendarDiagnosticObjects
   [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
   [-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>]
   [-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。

参数

-AutoRequeryOnMeetingId

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ConfigurationName

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CustomPropertyNames

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EndDate

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

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

Type:	ExDateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EntryId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EwsId

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExactMatch

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

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

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

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

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

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

Type:	UnifiedGroupOrUserMailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-ItemClass

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ItemIds

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MaxResults

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MeetingId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ODataId

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ShouldBindToItem

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ShouldDecodeEnums

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ShouldFetchAttendeeCollection

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ShouldFetchRecurrenceExceptions

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-StartDate

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

Type:	ExDateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Subject

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online