Get-CalendarDiagnosticLog
Obwohl dieses Cmdlet in lokalem Exchange und im cloudbasierten Dienst verfügbar ist, funktioniert es nur in lokalem Exchange. Verwenden Sie im cloudbasierten Dienst stattdessen das Cmdlet Get-CalendarDiagnosticObjects.
Verwenden Sie das Cmdlet Get-CalendarDiagnosticLog, um eine Reihe von Kalenderprotokollen zu erfassen. In den Kalenderdiagnoseprotokollen werden alle Kalenderelemente und Besprechungsanfragen in Postfächern nachverfolgt. Diese Informationen können Sie zum Behandeln von Kalenderproblemen verwenden, die in Postfächern auftreten.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-LogLocation <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-EndDate <ExDateTime>]
[-EntryId <String>]
[-ExactMatch <Boolean>]
[-ItemClass <String[]>]
[-ItemIds <String[]>]
[-Latest]
[-MeetingID <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-StartDate <ExDateTime>]
[-Subject <String>]
[<CommonParameters>] Beschreibung
Die Ausgabe dieses Cmdlets enthält die folgenden Informationen:
- IsFileLink: Gibt an, ob das Kalenderelement mithilfe des LogLocation-Parameters in eine MSG-Datei exportiert wurde. Gültige Werte sind "True" oder "False".
- Identity: Gibt das Postfach an, das das Kalenderelement enthält. Beispielwert: excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.
- LogDate: Das Datum und die Uhrzeit, zu der das Kalenderelement protokolliert wurde.
- NormalizedSubject: Das Subject-Feld des Kalenderelements.
- CleanGlobalObjectId: Der Bezeichner, der während der gesamten Lebensdauer des Kalenderelements gleich bleibt. Beispiel: 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.
Nachdem Sie das Cmdlet Get-CalendarDiagnosticLog ausgeführt haben, können Sie die Kalenderdaten mit dem Cmdlet Get-CalendarDiagnosticAnalysis analysieren. Weitere Informationen finden Sie unter Get-CalendarDiagnosticAnalysis.
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-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $trueIn diesem Beispiel werden die Kalenderdiagnoseprotokoll-Einträge für das Postfach von Shannon Steele abgerufen, wobei der Betreff "Weekly development meeting" verwendet wird.
Beispiel 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"In diesem Beispiel werden die Kalenderdiagnoseprotokolleinträge für das Postfach von Oscar Evans vom 06.01.2018 bis zum 30.06.2018 abgerufen.
Beispiel 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -LatestIn diesem Beispiel werden die Daten der Kalenderdiagnoseprotokolle nur für das aktuelle Kalenderelement im Postfach von Jasen Kozma abgerufen, wobei der Betreff "Weekly development meeting" verwendet wird.
Beispiel 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"In Exchange 2013 exportiert dieses Beispiel alle Kalenderelemente im Kalenderdiagnoseprotokoll für das Postfach von Jasen Kozma, die "Budget Meeting" an einer beliebigen Stelle im Betreff in den angegebenen Ordner enthalten.
Hinweise:
- In diesem Beispiel werden die Nachrichtendateien in C:\Eigene Dokumente\Kalenderdiagnoseexport\jkozma@contoso.com geschrieben.
- In lokalen Exchange-Organisationen können Sie das Cmdlet Get-CalendarDiagnosticAnalysis verwenden, um die exportierten MSG-Dateien zu analysieren.
- Dieses Beispiel funktioniert in Exchange 2016 oder Exchange 2019 nicht, da der LogLocation-Parameter nicht verfügbar ist.
Parameter
-Credential
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter Credential gibt den Benutzernamen und das Kennwort an, die zum Ausführen dieses Befehls verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.
Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EndDate
Der EndDate-Parameter gibt das Enddatum des Datumsbereichs an.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EntryId
Der EntryId-Parameter filtert die Ergebnisse nach Eintrags-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 Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Der Parameter Identity gibt das Postfach an, das die Kalenderelemente enthält. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. 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: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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.
Sie können nur diesen Parameter zusammen mit dem Parameter MeetingID verwenden.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Latest
Die Option Latest gibt an, ob Kalenderprotokolldaten nur für das aktuelle Kalenderelement zurückgegeben werden sollen. Sie müssen bei dieser Option keinen Wert angeben.
| Type: | SwitchParameter |
| 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. Die Verwendung dieses Cmdlets ist jetzt auf den lokalen Server beschränkt.
Dieser Parameter ist nur in Exchange 2010 und Exchange 2013 funktionsfähig.
Der Parameter LogLocation gibt den Speicherort an, an dem die Kalenderelemente in MSG-Dateien exportiert werden sollen. Sie können einen lokalen Pfad oder einen UNC-Pfad (\\Server\Share) angeben. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Am Speicherort, den Sie angeben, wird automatisch ein Unterordner für das angegebene Postfach erstellt, der die exportierten Kalenderelemente enthält. Wenn Sie beispielsweise den Wert "C:\Eigene Dokumente\Kalenderexport" angeben, um Kalenderelemente aus dem Postfach von Shannon Steele zu exportieren, werden die MSG-Dateien tatsächlich in C:\Meine Dokumente\Kalenderexport\ssteele@contoso.com gespeichert.
In lokalen Exchange-Organisationen können Sie das Cmdlet Get-CalendarDiagnosticAnalysis verwenden, um die exportierten MSG-Dateien zu analysieren.
Hinweis: Bei Befehlen, die diesen Parameter verwenden, treten möglicherweise Fehler auf, wenn das Kalenderelement über keinen Titel verfügt. Wenn Sie bei der Verwendung dieses Parameters Fehler erhalten, führen Sie den Befehl erneut aus, und ersetzen Sie diesen Parameter durch eine Umleitung zu einer Datei (| Set-Content -Path "C:\Meine Dokumente\Kalenderexport"), oder ersetzen Sie die Ausgabe durch eine PowerShell-Variable.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Online |
-MeetingID
Der MeetingID-Parameter filtert die Ergebnisse nach der GUID 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.
Um diesen Wert zu finden, ist es am einfachsten, zuerst mit den Parametern Subject, StartDate und EndDate nach dem Kalenderelement zu suchen. Nachdem Sie das gewünschte Kalenderelement gefunden haben, können Sie dessen CleanGlobalObjectId-Wert für den MeetingID-Parameter in zukünftigen Befehlen verwenden.
Verwenden Sie diesen Parameter nicht zusammen mit dem Subject-Parameter, da der Wert des MeetingID-Parameters Vorrang hat.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ReadFromDomainController
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Die Option ReadFromDomainController gibt an, dass Informationen von einem Domänencontroller in der Domäne des Benutzers gelesen werden sollen. Sie müssen keinen Wert für diese Option angeben.
Der Befehl Set-AdServerSettings -ViewEntireForest $true zum Einschließen aller Objekte in der Gesamtstruktur erfordert den ReadFromDomainController-Switch. Andernfalls könnte der Befehl einen globalen Katalog verwenden, der veraltete Informationen enthält. Außerdem müssen Sie möglicherweise mehrere Iterationen des Befehls mit dem ReadFromDomainController-Switch ausführen, um die Informationen abzurufen.
Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Exchange-Server befinden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-StartDate
Der StartDate-Parameter gibt das Startdatum und die Uhrzeit des Datumsbereichs an.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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, setzen Sie ihn in Anführungszeichen ("). Sie können festlegen, ob die genaue Übereinstimmung beim Verwenden des ExactMatch-Parameters verwendet wird.
Verwenden Sie diesen Parameter nicht zusammen mit dem MeetingID-Parameter, da der Wert des MeetingID-Parameters Vorrang hat.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, 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.