Get-CalendarDiagnosticAnalysis

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

雖然此 Cmdlet 可在內部部署 Exchange 和雲端式服務中使用，但它只適用于內部部署 Exchange。

使用 Get-CalendarDiagnosticAnalysis 指令程式疑難排解行事曆的相關可靠性問題。您可以使用此 Cmdlet 來分析行事曆診斷記錄中記錄的行事曆專案資料。您可以使用 Get-CalendarDiagnosticLog Cmdlet 將行事曆專案資料提供給此 Cmdlet。

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

Syntax

Get-CalendarDiagnosticAnalysis
   -CalendarLogs <CalendarLog[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Get-CalendarDiagnosticAnalysis
   -LogLocation <String[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Description

當 DetailLevel 參數設定為 [基本]) 時，會在 Cmdlet (的預設輸出中傳回行事曆專案的下列屬性：

本機記錄時間
ItemId
NormalizedSubject
StartTime
EndTime
CalendarLogTriggerAction
ClientInfoString
OriginalLastModifiedTime
ClientIntent
CleanGlobalObjectId
ItemClass
ParentDisplay
持續時間
AppointmentRecurring
SentRepresentingEmailAddress
SenderEmailAddress
SentRepresentingDisplayName

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F

Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"

這則範例會從您的 Mailbox 取得指定的行事曆專案、將專案儲存為變數，並將專案的進階分析寫入 CSV 檔案。

若要進行專案的基本分析，請勿包含 DetailLevel 參數，或使用值 Basic 而非 Advanced。

範例 2

Get-CalendarDiagnosticAnalysis -LogLocation "C:\My Documents\Exported Calendar Logs\jkozma@contoso.com" -DetailLevel Advanced -OutputAs HTML | Set-Content -Path "C:\My Documents\Jasen Kozma Analysis.html"

在 Exchange 2013中，此範例會使用 Get-CalendarDiagnosticLog Cmdlet 搭配 LogLocation 參數，分析先前從 Jasen Kozma 信箱匯出的行事曆專案，並將專案的進階分析寫入 HTML 檔案。

注意：LogLocation 參數僅適用于 Exchange 2013。若要指定匯出的行事曆專案在 Exchange 2016 或 Exchange 2019 中的位置，請參閱範例 3。

如需專案的基本分析，請勿包含 DetailLevel 參數，或使用值 Basic 而非 Advanced。

範例 3

$calitems = Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Budget Meeting"

ForEach($item in $calitems){$i++; Get-CalendarDiagnosticAnalysis -CalendarLogs $item -OutputAs HTML | Set-Content -Path ("\\FileServer01\Data\Jasen Kozma Analysis{0}.html" -f $i)}

本範例使用 Get-CalendarDiagnosticLog Cmdlet 分析從 Jasen Kozma 信箱匯出的行事曆專案，並使用 UNC 路徑將每個專案的進階分析寫入 HTML 檔案。

如需專案的基本分析，請勿包含 DetailLevel 參數，或使用值 Basic 而非 Advanced。

參數

-CalendarLogs

CalendarLogs 參數會指定您要分析的行事曆專案。您可以將Get-CalendarDiagnosticLog Cmdlet 的輸出儲存至變數，並將該變數用於此參數的值，以識別行事曆專案。

例如，若要分析會議的主旨為「November Budget Meeting」，請執行命令 $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch ，然後使用此參數的值 $Budget 。

您用於此參數的值必須識別單一專案。若要識別多個專案，請參閱範例 3。

您無法搭配 LogLocation 參數使用此參數。

Type:	CalendarLog[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DetailLevel

DetailLevel 參數會指定您想在分析輸出中所查看的詳細資料層級。有效值為：

基本：這是預設值。傳回的行事曆專案屬性會列在詳細描述中。
進階：會傳回 37 個額外的行事曆專案屬性。您應該只將此值用於詳細的偵錯資訊。

Type:	AnalysisDetailLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-GlobalObjectId

GlobalObjectId 參數會指定您要分析之行事曆專案的身分識別。在 Exchange 2013 中，如果位置包含多個匯出的 .msg 檔案，您可以使用此參數搭配 LogLocation 參數來指定行事曆專案。

會議的 GlobalObjectId 屬性使用與 CleanGlobalObjectId 屬性相同的格式 (例如，040000008200E00074C5B7101A82E00800000009421DCCD5046CD01000000000000001000000010B0349F6B17454685E17D9F9512E71F) ，且兩個屬性的值可能相同。不過，對於多個行事曆中相同會議的所有實例，GlobalObjectId 的值可能不會保持不變 (例如，邀請到相同週期性會議) 之不同實例的不同出席者。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogLocation

注意：2022 H1 累積更新已從 Exchange 2016 和 Exchange 2019移除此參數，因為它接受 UNC 路徑值。若要指定要分析的行事曆專案，請使用 CalendarLogs 參數。

此參數只能在 Exchange 2013 中運作。

LogLocation 參數會指定您要分析之匯出行事曆專案的位置。您可以指定本機路徑或 UNC 路徑 () \\Server\Share\User 。如果值包含空格，請使用引號 (") 括住值。

您可以使用 Get-CalendarDiagnosticLog Cmdlet 搭配 LogLocation 參數，將行事曆專案匯出至 .msg 檔案。如果路徑包含多個 .msg 檔案，則當您執行 Get-CalendarDiagnosticAnalysis 時，會分析所有這些檔案。

您無法搭配 CalendarLogs 參數使用此參數。

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

-OutputAs

OutputAs 參數會指定命令的輸出格式。有效值為：

CSV (這是預設值)
HTML
XML

Type:	OutputType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

共用方式為