Freigeben über


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

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 ist empfangen, 4 = Der Termin wird 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>; oder Client=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. 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 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

-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 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 der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/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

{{ EwsId-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

-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 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 Thema "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. Dieser Wert ist die Standardeinstellung.

Eine Partielle Suche nach Betreffübereinstimmungen 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.

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)

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter 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 ItemIds-Parameter filtert die Ergebnisse nach 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 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.

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

{{ Fill ODataId 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

-ResultSize

Anwendbar: Exchange Online

Dieser Parameter bestimmt die Anzahl der vom Cmdlet zurückgegebenen Ergebnisse. 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 die Standardeinstellung.

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: 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. Dieser Wert ist die Standardeinstellung.

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

-StartDate

Anwendbar: Exchange Online

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 der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/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.