Get-CalendarDiagnosticObjects

模組:
Exchange PowerShell

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

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

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 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

本範例會從 Pedro 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) 的會議擷取 Pedro 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

此範例傳回 Pedro Pizarro 信箱中於 2018 年 7 月修改之會議主題為 Team Lunch 的會議診斷資訊，並將結果匯出至檔案 C：\My Documents\Team Lunch Meeting.csv。

參數

-AnalyzeExceptionWithOriginalStartDate

適用：Exchange Online

{{ Fill AnalyzeExceptionWithOriginalStartDate 描述 }}

參數屬性

類型: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

{{ 填滿 ConfigurationName 描述 }}

參數屬性

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EwsId

適用：Exchange Online

{{ 填滿 EwsId 描述 }}

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExactMatch

適用：Exchange Online

ExactMatch 參數會指定您是否對您為 [主旨] 參數指定的文字值使用完全相符或部分相符。 有效值為：

  • $true：主旨搜尋使用完全相符並搜尋信箱中的所有行事曆項目。 例如，如果您搜尋 “budget”，搜尋會尋找主旨中任何位置有 “budget” 的項目，但不會尋找 “budgeting” 的項目。
  • $false：主旨搜尋使用部分比對，並在信箱中搜尋最多 1000 個行事曆項目。 例如，如果您搜尋 “budget”，搜尋會尋找主旨中任何位置含有 “budget” 和 “budgeting” 的項目。 此值為預設值。

部分主題比對搜尋可能不會傳回所有相關的行事曆項目。 請嘗試使用完全比對主題搜尋，以獲得更準確的結果。

您只能將此參數與 [主旨] 參數搭配使用。

使用 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
  • 使用者識別碼或使用者主要名稱 (UPN)

警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

類型: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 參數會依項目識別碼篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaxResults

適用：Exchange Online

{{ 填滿 MaxResults 描述 }}

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MeetingId

適用：Exchange Online

MeetingId 參數會依行事曆項目的全域唯一識別碼來篩選結果。 此值是此 Cmdlet 輸出中或使用其他 MAPI 檢查工具所提供的行事曆項目的 CleanGlobalObjectId 屬性。 範例值為 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55。 此值在行事曆項目的整個存留期間都是恆定的。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ODataId

適用：Exchange Online

{{ 填滿 ODataId 描述 }}

參數屬性

類型: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 描述 }}

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ShouldFetchAttendeeCollection

適用：Exchange Online

{{ Fill ShouldFetchAttendeeCollection 描述 }}

參數屬性

類型: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 描述 }}

參數屬性

類型: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。