Get-CalendarDiagnosticObjects
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet Get-CalendarDiagnosticObjects, um einen Bereich von Kalenderprotokollen zu erfassen. Die Kalenderdiagnoseprotokolle verfolgen wichtige kalenderbezogene Ereignisdaten für jedes Postfach nach und können zur Behandlung von Kalenderproblemen verwendet werden, die in Postfächern auftreten. Die Protokolle verfolgen alle Kalenderelemente und Besprechungsnachrichten nach.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
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>]
Beschreibung
Einige weitere interessante Eigenschaften, die in die Ergebnisse zurückgegeben werden, sind die folgenden:
- AppointmentState: 1 = Der Termin ist eine Besprechung, 2 = Der Termin wurde empfangen, 4 = Der Termin wurde abgebrochen, und 8 = der Termin ist ein weitergeleiteter Termin.
- CalendarLogTriggerAction: Die Aktion, die für das Element ausgeführt wird (z. B. Erstellen oder Aktualisieren).
- ClientInfoString: Die Entität,
Client=OWA;<AdditionalDetails>
die die Änderung vorgenommen hat (z. B. ,Client=WebServices;<AdditionalDetails>
; oderClient=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;
). - MeetingRequestType: 1 = Die Besprechungsnachricht ist eine Besprechungsanfrage, 65536 = Die Besprechungsnachricht ist ein vollständiges Update einer vorhandenen Besprechung, 131072 = Die Besprechungsnachricht ist eine informationsbasierte Aktualisierung einer vorhandenen Besprechung, 262144 = Die Besprechungsnachricht ist ein automatisches Update, 524288 = Das Update ist veraltet, oder 1048576 = Die Besprechungsnachricht wird an einen Delegaten weitergeleitet, und die Kopie wird als informational markiert.
- OriginalLastModifiedTime: Wird als primäres Sortierfeld zum Sortieren der Ereignisse verwendet.
- ResponseType: 0 = Der Organisator hat keine Antwort erhalten, 1 = Die Kopie des Organisators der Besprechung, 2 = Mit Vorbehalt, 3 = Annehmen, 4 = Ablehnen oder 5 = Der Teilnehmer hat nicht geantwortet.
- ResponsibleUserName: Der LegacyExchangeDN-Wert des Benutzers,
/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant
der die Änderung vorgenommen hat (z. B. oder/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin
).
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
Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true
In diesem Beispiel werden Kalenderdiagnoseprotokolle des Postfachs von Pedro Pizarro für alle Elemente abgerufen, deren Betreff exakt mit „Team Meeting“ übereinstimmt.
Beispiel 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
Dies ist identisch mit dem vorherigen Beispiel, aber jetzt werden die Ergebnisse nach dem Zeitpunkt der letzten Änderung sortiert.
Beispiel 3
Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49
In diesem Beispiel werden die Kalenderdiagnoseprotokolle des Postfachs von Pedro Pizarro für eine Besprechung mit der angegebenen eindeutigen globalen Objekt-ID (GOID) abgerufen.
Beispiel 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
In diesem Beispiel werden Diagnoseinformationen für Besprechungen mit dem Betreff Team Lunch im Postfach von Pedro Pizarro zurückgegeben, die im Juli 2018 geändert wurden, und die Ergebnisse werden in die Datei C:\Meine Dokumente\Team lunch Meeting.csv exportiert.
Parameter
-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
{{ Fill ConfigurationName Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-CustomPropertyNames
Der CustomPropertyNames-Parameter gibt die benutzerdefinierte Eigenschaft des Kalenderelements in den Ergebnissen zurück. Gültige Werte finden Sie unter Werte für den CustomPropertyNames-Parameter in Exchange Online PowerShell.
Es können mehrere Werte durch Kommata getrennt angegeben werden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-EndDate
Der Parameter EndDate gibt das Enddatum des Datumsbereichs für die OriginalLastModifiedTime-Eigenschaft an (als die Besprechung zuletzt geändert, nicht erstellt wurde).
Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".
Type: | ExDateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-EntryId
Der EntryID-Parameter filtert die Ergebnisse nach dem angegebenen EntryID-Eigenschaftswert, die der MAPI-Eigenschaft PR_ENTRYID entspricht.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-EwsId
{{ EwsId-Beschreibung ausfüllen }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExactMatch
Der ExactMatch-Parameter gibt an, ob eine genaue Entsprechung oder eine teilweise Übereinstimmung für Textwerte verwendet wird, die Sie für den Subject-Parameter angeben. Gültige Werte sind:
- $true: Die Betreffsuche verwendet eine genaue Übereinstimmung und durchsucht alle Kalenderelemente im Postfach. Wenn Sie beispielsweise nach "Budget" suchen, sucht die Suche nach Elementen, die an einer beliebigen Stelle im Betreff "Budget" enthalten, aber nicht nach "Budgetierung".
- $false: Die Betreffsuche verwendet eine partielle Übereinstimmung und durchsucht maximal 1000 Kalenderelemente im Postfach. Wenn Sie beispielsweise nach "Budget" suchen, sucht die Suche nach Elementen, die an einer beliebigen Stelle im Betreff "Budget" und "Budgetierung" enthalten. Dies ist der Standardwert.
Eine teilweise Übereinstimmung gibt möglicherweise nicht alle relevanten Kalenderelemente zurück. Versuchen Sie, eine Suche mit einer genauen Übereinstimmung durchzuführen, um genauere Ergebnisse zu erzielen.
Sie verwenden diesen Parameter nur mit dem Subject-Parameter.
Der Wert dieses Parameters wird ignoriert, wenn Sie den MeetingId-Parameter verwenden.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
Der Parameter Identity gibt das Postfach oder die Microsoft 365-Gruppe an, deren Kalender Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der das Postfach oder die Microsoft 365-Gruppe eindeutig identifiziert. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Type: | UnifiedGroupOrUserMailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ItemClass
Der ItemClass-Parameter filtert die Ergebnisse nach dem angegebenen MessageClass-Eigenschaftswert des Kalenderelements (zum Beispiel IPM.Appointment). Es können mehrere Werte durch Kommata getrennt angegeben werden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ItemIds
Der Parameter ItemIds filtert die Ergebnisse nach Element-ID. Es können mehrere Werte durch Kommata getrennt angegeben werden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MaxResults
{{ Fill MaxResults Description }}
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MeetingId
Der MeetingId-Parameter filtert die Ergebnisse nach dem global eindeutigen Bezeichner des Kalenderelements. Der Wert ist die CleanGlobalObjectId-Eigenschaft des Kalenderelements, das in der Ausgabe dieses Cmdlets oder mithilfe anderer MAPI-Untersuchungstools verfügbar ist. Ein Beispielwert ist 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Dieser Wert bleibt während der gesamten Lebensdauer des Kalenderelements gleich.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ODataId
{{ Fill ODataId Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ResultSize
Dieser Parameter bestimmt die Anzahl der vom Cmdlet zurückgegebenen Ergebnisse. Der Höchstwert ist 1000.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ShouldBindToItem
Der ShouldBindToItem-Parameter gibt an, ob große streamfähige Eigenschaftswerte abgeschnitten werden (z. B. AppointmentRecurrenceBlob). Gültige Werte sind:
- $true: Die Werte großer streambarer Eigenschaften werden nicht abgeschnitten, sodass der vollständige Wert zurückgegeben wird.
- $false: Die Werte großer streambarer Eigenschaften werden abgeschnitten. Dies ist der Standardwert.
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
Der Parameter ShouldFetchRecurrenceExceptions gibt an, ob Ausnahmen bei Besprechungsserien einbezogen werden. Gültige Werte sind:
- $true: Schließen Sie Ausnahmen für Besprechungsserien ein. Bei Verwendung dieses Werts müssen Sie auch den Parameter ItemIds verwenden.
- $false: Schließen Sie keine Ausnahmen für Besprechungsserien ein. Dies ist der Standardwert.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-StartDate
Der Parameter StartDate gibt das Startdatum des Datumsbereichs für die OriginalLastModifiedTime-Eigenschaft an (als die Besprechung zuletzt geändert, nicht erstellt wurde).
Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".
Type: | ExDateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Subject
Der Subject-Parameter identifiziert Kalenderelemente anhand des angegebenen Texts im Subject-Feld. Bei den von Ihnen angegebenen Textwerten wird keine Groß- und Kleinschreibung unterschieden. Wenn der Wert Leerzeichen enthält, muss er in Anführungszeichen („“) gesetzt werden. Sie können festlegen, ob die genaue Übereinstimmung beim Verwenden des ExactMatch-Parameters verwendet wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |