Get-CalendarDiagnosticObjects

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Online

此指令程式只能在雲端式服務中使用。

使用 Get-CalendarDiagnosticObjects Cmdlet 來收集行事曆記錄的範圍。 行事曆診斷記錄會追蹤每個信箱的重要行事曆相關事件資料，並可用來針對信箱中發生的行事曆問題進行疑難排解。 記錄會追蹤所有的行事曆項目和會議郵件。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

結果中傳回的一些更有趣的屬性如下：

  • 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 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

本範例會針對主旨與小組會議完全相符的所有專案，擷取來自一般 Pizarro 信箱的行事曆診斷記錄。

範例 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

本範例會擷取具有指定之唯一全域物件識別碼 (GOID) 之會議的 Calendar Pizarro 信箱行事曆診斷記錄。

範例 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 月修改之在於 2018 年 7 月修改之主題 Team Lunch 會議的診斷資訊，並將結果匯出至 C：\My Documents\Team Lunch Meeting.csv 檔案。

參數

-AutoRequeryOnMeetingId

{{ Fill AutoRequeryOnMeetingId Description }}

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

-ConfigurationName

{{ 填滿 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 屬性值來篩選結果，該值會對應至 MAPI 屬性PR_ENTRYID。

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

-EwsId

{{ 填滿 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)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (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 參數會依專案識別碼篩選結果。 您可以指定多個以逗號分隔的值。

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

-MaxResults

{{ 填入 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 檢查工具。 範例值為 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000010000000005B27C05AA7C4646B0835D5EB4E41C55。 這個值在行事曆專案的存留期內是常數。

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

-ODataId

{{ 填滿 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

{{ Fill ShouldDecodeEnums Description }}

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

-ShouldFetchAttendeeCollection

{{ Fill ShouldFetchAttendeeCollection Description }}

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 屬性的日期範圍開始日期， (上次修改會議時，而不是建立) 。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 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

-Subject

Subject 參數會依 [主旨] 欄位中的指定文字來識別行事曆專案。 您指定的文字值不區分大小寫。 如果值包含空格，請使用引號括住值。 您可以使用 ExactMatch 參數來控制是否要使用精確比對

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