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

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