Export (0) Print
Expand All
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

Get-CalendarDiagnosticLog

 

Applies to: Exchange Server 2013, Exchange Online

Topic Last Modified: 2012-08-08

Use the Get-CalendarDiagnosticLog cmdlet to collect a range of calendar logs. The Calendar Diagnostic logs track important calendar-related event data for each mailbox and can be used to troubleshoot calendar issues that occur in mailboxes. The logs track all calendar items and meeting messages.

For information about the parameter sets in the Syntax section below, see Syntax.

Get-CalendarDiagnosticLog -Identity <MailboxIdParameter> <COMMON PARAMETERS>

Get-CalendarDiagnosticLog -Identity <MailboxIdParameter> -LogLocation <String> <COMMON PARAMETERS>

COMMON PARAMETERS: [-Credential <PSCredential>] [-DomainController <Fqdn>] [-EndDate <ExDateTime>] [-Identity <MailboxIdParameter>] [-Latest <SwitchParameter>] [-MeetingID <String>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-StartDate <ExDateTime>] [-Subject <String>]

This example retrieves the Calendar Diagnostic logs for Tony Smith's mailbox by using the subject Weekly development meeting.

Get-CalendarDiagnosticLog -Identity Tony -Subject "Weekly development meeting"

This example retrieves the Calendar Diagnostic logs for Tony Smith's mailbox from 6/1/2012 to 6/30/2012.

Get-CalendarDiagnosticLog -Identity Tony -StartDate "6/1/2012 6:00:00 AM" -EndDate "6/30/2012 5:00:00 PM"

This example retrieves the Calendar Diagnostic log data only for the most recent calendar item in Tony Smith's mailbox with a message subject of "Weekly development meeting".

Get-CalendarDiagnosticLog -Identity Tony -Subject "Weekly development meeting" -Latest

After you run the Get-CalendarDiagnosticLog cmdlet, you can analyze the calendar data using the Get-CalendarDiagnosticAnalysis cmdlet. For more information, see Get-CalendarDiagnosticAnalysis.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Calendar diagnostics" entry in the Recipients Permissions topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

The Identity parameter specifies the mailbox user's name. This is the name that appears in Active Directory Users and Computers. This is also the user name that appears in Recipient Properties on the User Information tab. You can use the following values:

  • Alias

  • Display name

  • Domain\Account

  • SMTP address

  • Distinguished name (DN)

  • Object GUID

  • User principal name (UPN)

  • LegacyExchangeDN

LogLocation

Required

System.String

The LogLocation parameter specifies the location of the log files. The log files are located in the Exchange Logging directory.

Credential

Optional

System.Management.Automation.PSCredential

The Credential parameter specifies the user name and password to use to access Active Directory Domain Services (AD DS).

This parameter requires the creation and passing of a credential object. This credential object is created by using the Get-Credential cmdlet. For more information, see Get-Credential.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

EndDate

Optional

Microsoft.Exchange.ExchangeSystem.ExDateTime

The EndDate parameter specifies an end date for filtering content that's exported from the source mailbox. Only items in the mailbox whose date is prior to or the same as the end date are exported. The default time is the current time. When you enter a specific date, use the short date format defined in the Regional Options settings configured on the local computer. For example, if your computer is configured to use the short date format mm/dd/yyyy, enter 03/01/2012 to specify March 1, 2012. You can enter the date only, for example, 10/05/2011. Or you can enter the date and time of day. If you enter a time of day and date, you must enclose the argument in quotation marks ("), for example, "10/05/2011 5:00:00 PM".

Latest

Optional

System.Management.Automation.SwitchParameter

The Latest switch specifies whether to return calendar log data for only the most recent calendar item.

MeetingID

Optional

System.String

This parameter is reserved for internal Microsoft use.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

The ReadFromDomainController parameter specifies that the calendar diagnostic information is read from a domain controller in the user's domain. If you use this parameter, multiple reads might be necessary to get the information.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

The ResultSize parameter specifies the maximum number of results to return. If you want to return all mailboxes that match the query, use unlimited for the value of this parameter. The default value is 1000.

StartDate

Optional

Microsoft.Exchange.ExchangeSystem.ExDateTime

The StartDate parameter specifies a start date and time for filtering content that's exported from the source mailbox. Only items in the mailbox whose date is later than the start date are exported. For valid date and time formatting options, refer to the description of the EndDate parameter.

Subject

Optional

System.String

The Subject parameter specifies the subject of the calendar item or meeting request. You can't use this parameter in conjunction with the MeetingID parameter.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.