Get-CalendarDiagnosticObjects

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Get-CalendarDiagnosticObjects, um eine Reihe von Kalenderprotokollen zu erfassen. Die Kalenderdiagnoseprotokolle verfolgen wichtige kalenderbezogene Ereignisdaten für jedes Postfach und können verwendet werden, um Kalenderprobleme zu behandeln, 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

Default (Standard) 

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

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 wird empfangen, 4 = der Termin wird abgesagt, 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, die die Änderung vorgenommen hat (z. B. Client=OWA;<AdditionalDetails>, Client=WebServices;<AdditionalDetails>;, oder Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;).
  • MeetingRequestType: 1 = die Besprechungsnachricht ist eine Besprechungsanfrage, 65536 = die Besprechungsnachricht stellt ein vollständiges Update einer vorhandenen Besprechung dar, 131072 = die Besprechungsnachricht ist ein Informationsupdate für eine bestehende Besprechung, 262144 = die Besprechungsnachricht ist ein unbeaufsichtigtes Update, 524288 = das Update veraltet ist, oder 1048576 = die Besprechungsnachricht wird an eine Stellvertretung weitergeleitet, und die Kopie ist als informativ gekennzeichnet.
  • OriginalLastModifiedTime: Wird als primäres Sortierfeld zum Sortieren der Ereignisse verwendet.
  • ResponseType: 0 = Der Organisator hat keine Antwort erhalten, 1 = Die Kopie der Besprechung des Organisators, 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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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 stimmt mit dem vorherigen Beispiel überein, nur dass die Ergebnisse nach dem ursprünglichen Zeitpunkt der letzten Änderung sortiert sind.

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

Dieses Beispiel gibt Diagnoseinformationen für Besprechungen mit dem Betreff Team Lunch im Postfach von Pedro Pizarro zurück, die im Juli 2018 geändert wurden, und exportiert die Ergebnisse in die Datei C:\Eigene Dateien\Team Lunch Meeting.csv.

Parameter

-AnalyzeExceptionWithOriginalStartDate

Anwendbar: Exchange Online

{{ Fill AnalyzeExceptionWithOriginalStartDate Description }}

Parametereigenschaften

Typ:ExDateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AutoRequeryOnMeetingId

Anwendbar: Exchange Online

{{ Fill AutoRequeryOnMeetingId Description }}

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConfigurationName

Anwendbar: Exchange Online

{{ Fill ConfigurationName Description }}

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomPropertyNames

Anwendbar: Exchange Online

Der CustomPropertyNames-Parameter gibt die benutzerdefinierte Eigenschaft des Kalenderelements in den Ergebnissen zurück. Gültige Werte finden Sie unter Werte für den Parameter CustomPropertyNames in Exchange Online PowerShell.

Es können mehrere Werte durch Kommata getrennt angegeben werden.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndDate

Anwendbar: Exchange Online

Der Parameter EndDate gibt das Enddatum des Datumsbereichs für die Eigenschaft OriginalLastModifiedTime an (wann die Besprechung zuletzt geändert und nicht erstellt wurde).

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/JJJJ konfiguriert ist, geben Sie 01.09.2018 ein, um 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".

Parametereigenschaften

Typ:ExDateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EntryId

Anwendbar: Exchange Online

Der EntryID-Parameter filtert die Ergebnisse nach dem angegebenen EntryID-Eigenschaftswert, die der MAPI-Eigenschaft PR_ENTRYID entspricht.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EwsId

Anwendbar: Exchange Online

{{ Fill EwsId Description }}

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExactMatch

Anwendbar: Exchange Online

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 Betreffzeile verwendet eine exakte Übereinstimmung und durchsucht alle Kalenderelemente im Postfach. Wenn Sie z. B. nach "Budget" suchen, wird nach Elementen gesucht, die an einer beliebigen Stelle im Betreff "Budget" enthalten, aber nicht nach "Budgetierung".
  • $false: Die Betreffzeile verwendet eine Teilübereinstimmung und durchsucht maximal 1000 Kalenderelemente im Postfach. Wenn Sie z. B. nach "Budget" suchen, sucht die Suche nach Elementen, die irgendwo im Betreff "Budget" und "Budgetierung" enthalten. Dieser Wert ist der Standardwert.

Eine Suche nach teilweiser Betreffü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 Parameter Subject.

Der Wert dieses Parameters wird ignoriert, wenn Sie den MeetingId-Parameter verwenden.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: Exchange Online

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. Zum 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)

Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:UnifiedGroupOrUserMailboxIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ItemClass

Anwendbar: Exchange Online

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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ItemIds

Anwendbar: Exchange Online

Der Parameter ItemIds filtert die Ergebnisse nach der Element-ID. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MaxResults

Anwendbar: Exchange Online

{{ Fill MaxResults Description }}

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MeetingId

Anwendbar: Exchange Online

Der Parameter MeetingId 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 bei Verwendung anderer MAPI-Prüfungstools verfügbar ist. Ein Beispielwert ist 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Dieser Wert bleibt während der gesamten Lebensdauer des Kalenderelements gleich.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ODataId

Anwendbar: Exchange Online

{{ ODataId-Beschreibung ausfüllen }}

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResultSize

Anwendbar: Exchange Online

Dieser Parameter bestimmt die Anzahl der Ergebnisse, die vom Cmdlet zurückgegeben werden. Der Höchstwert ist 1000.

Parametereigenschaften

Typ:Unlimited
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShouldBindToItem

Anwendbar: Exchange Online

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. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShouldDecodeEnums

Anwendbar: Exchange Online

{{ Fill ShouldDecodeEnums Description }}

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShouldFetchAttendeeCollection

Anwendbar: Exchange Online

{{ Fill ShouldFetchAttendeeCollection Description }}

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShouldFetchRecurrenceExceptions

Anwendbar: Exchange Online

Der Parameter ShouldFetchRecurrenceExceptions gibt an, ob Ausnahmen bei Besprechungsserien einbezogen werden. Gültige Werte sind:

  • $true: Ausnahmen für wiederkehrende Besprechungen einbeziehen. Bei Verwendung dieses Werts müssen Sie auch den Parameter ItemIds verwenden.
  • $false: Schließen Sie keine Ausnahmen für wiederkehrende Besprechungen ein. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShouldResolveParticipants

Anwendbar: Exchange Online

{{ Fill ShouldResolveParticipants Beschreibung }}

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StartDate

Anwendbar: Exchange Online

Der Parameter StartDate gibt das Startdatum des Datumsbereichs für die Eigenschaft OriginalLastModifiedTime an (wann die Besprechung zuletzt geändert und nicht erstellt wurde).

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/JJJJ konfiguriert ist, geben Sie 01.09.2018 ein, um 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".

Parametereigenschaften

Typ:ExDateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Subject

Anwendbar: Exchange Online

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, setzen Sie ihn in Anführungszeichen ("). Sie können festlegen, ob die genaue Übereinstimmung beim Verwenden des ExactMatch-Parameters verwendet wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.