Get-CalendarDiagnosticAnalysis
Obwohl dieses Cmdlet in lokalem Exchange und im cloudbasierten Dienst verfügbar ist, funktioniert es nur in lokalem Exchange.
Verwenden Sie das Get-CalendarDiagnosticAnalysis-Cmdlet, um kalenderbezogene Probleme im Hinblick auf die Zuverlässigkeit zu behandeln. Sie können dieses Cmdlet für die Analyse von Kalenderelementdaten verwenden, die in den Protokollen für die Kalenderdiagnose erfasst wurden. Stellen Sie die Kalenderelementdaten für dieses Cmdlet mithilfe des Get-CalendarDiagnosticLog-Cmdlets bereit.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Get-CalendarDiagnosticAnalysis
-CalendarLogs <CalendarLog[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>] Get-CalendarDiagnosticAnalysis
-LogLocation <String[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>] Beschreibung
Die folgenden Eigenschaften des Kalenderelements werden in der standardmäßigen Ausgabe des Cmdlets zurückgegeben (wenn der DetailLevel-Parameter auf Basic festgelegt ist):
- Lokale Protokollzeit
- ItemId
- NormalizedSubject
- StartTime
- EndTime
- CalendarLogTriggerAction
- ClientInfoString
- OriginalLastModifiedTime
- ClientIntent
- CleanGlobalObjectId
- ItemClass
- ParentDisplay
- Dauer
- AppointmentRecurring
- SentRepresentingEmailAddress
- SenderEmailAddress
- SentRepresentingDisplayName
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F
Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"In diesem Beispiel wird das angegebene Kalenderelement aus dem Postfach von Oscar Evans abgerufen, das Element als Variable gespeichert und die erweiterte Analyse des Elements in eine CSV-Datei geschrieben.
Für die grundlegende Analyse des Elements sollten Sie den DetailLevel-Parameter nicht hinzufügen. Verwenden Sie den Wert Basic anstelle von Advanced.
Beispiel 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"In Exchange 2013 analysiert dieses Beispiel die Kalenderelemente, die zuvor aus dem Postfach von Jasen Kozma exportiert wurden, mithilfe des Cmdlets Get-CalendarDiagnosticLog mit dem LogLocation-Parameter und schreibt die erweiterte Analyse der Elemente in eine HTML-Datei.
Hinweis: Der LogLocation-Parameter ist nur in Exchange 2013 verfügbar. Informationen zum Angeben des Speicherorts exportierter Kalenderelemente in Exchange 2016 oder Exchange 2019 finden Sie unter Beispiel 3.
Für die grundlegende Analyse der Elemente sollten Sie den DetailLevel-Parameter nicht hinzufügen. Verwenden Sie den Wert Basic anstelle von Advanced.
Beispiel 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)}In diesem Beispiel werden die Kalenderelemente analysiert, die mithilfe des Cmdlets Get-CalendarDiagnosticLog aus dem Postfach von Jasen Kozma exportiert wurden, und die erweiterte Analyse für jedes Element mithilfe eines UNC-Pfads in eine HTML-Datei geschrieben.
Für die grundlegende Analyse der Elemente sollten Sie den DetailLevel-Parameter nicht hinzufügen. Verwenden Sie den Wert Basic anstelle von Advanced.
Parameter
-CalendarLogs
Der Parameter CalendarLogs gibt das Kalenderelement an, das analysiert werden soll. Sie identifizieren das Kalenderelement, indem Sie die Ausgabe des cmdlets Get-CalendarDiagnosticLog in einer Variablen speichern und diese Variable für den Wert dieses Parameters verwenden.
Um beispielsweise die Besprechung mit dem Betreff "November Budget Meeting" im Postfach von Shannon Steele zu analysieren, führen Sie den Befehl $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch aus, und verwenden Sie dann den Wert $Budget für diesen Parameter.
Der Wert, den Sie für diesen Parameter verwenden, muss ein einzelnes Element identifizieren. Informationen zum Identifizieren mehrerer Elemente finden Sie unter Beispiel 3.
Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter 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
Der Parameter DetailLevel gibt die Detailebene für die Ausgabe der Analyse an. Gültige Werte sind:
- Basic: Dies ist der Standardwert. Die Kalenderelementeigenschaften, die zurückgegeben werden, werden in der detaillierten Beschreibung aufgeführt.
- Advanced: 37 zusätzlichen Kalenderelementeigenschaften werden zurückgegeben. Sie sollten diesen Wert nur für ausführliche Debugginginformationen verwenden.
| 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
Der Parameter GlobalObjectId gibt die Identität des Kalenderelements an, das analysiert werden soll. In Exchange 2013 können Sie diesen Parameter mit dem LogLocation-Parameter verwenden, um das Kalenderelement anzugeben, wenn der Speicherort mehrere exportierte MSG-Dateien enthält.
Die GlobalObjectId-Eigenschaft der Besprechung verwendet das gleiche Format wie die CleanGlobalObjectId-Eigenschaft (z. B. 040000008200E00074C5B7101A82E0000000009421DCCD5046CD01000000000000000100000010B0349F6B17454685E17D9F9512E71F) und der Wert der beiden Eigenschaften ist wahrscheinlich gleich. Der Wert von GlobalObjectId ist jedoch möglicherweise nicht für alle Instanzen der gleichen Besprechung in mehreren Kalendern identisch (z. B. verschiedene Teilnehmer wurden zu unterschiedlichen Instanzen der gleichen wiederkehrenden Besprechung eingeladen).
| 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
Hinweis: Dieser Parameter wurde vom kumulativen 2022 H1-Aktualisierungen aus Exchange 2016 und Exchange 2019 entfernt, da er UNC-Pfadwerte akzeptiert. Verwenden Sie den CalendarLogs-Parameter, um die zu analysierenden Kalenderelemente anzugeben.
Dieser Parameter ist nur in Exchange 2013 funktionsfähig.
Der Parameter LogLocation gibt den Speicherort der exportierten Kalenderelemente an, die analysiert werden sollen. Sie können einen lokalen Pfad oder einen UNC-Pfad (\\Server\Share\User) angeben. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Sie exportieren die Kalenderelemente mithilfe des Cmdlets Get-CalendarDiagnosticLog mit dem LogLocation-Parameter in MSG-Dateien. Wenn der Pfad mehrere MSG-Dateien enthält, werden alle diese Dateien beim Ausführen von Get-CalendarDiagnosticAnalysis analysiert.
Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter 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
Der Parameter OutputAs gibt das Ausgabeformat des Befehls an. Gültige Werte sind:
- CSV (Dies ist der Standardwert.)
- 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 |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für