Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2012-11-15

Use the Get-CalendarDiagnosticLog cmdlet to view the Calendar Diagnostic log, which tracks important metrics for each mailbox and can be used to troubleshoot calendar issues that occur in mailboxes. The log tracks all calendar items and meeting messages.

Syntax

Get-CalendarDiagnosticLog -Identity <MailboxIdParameter> -Subject <String> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-LogLocation <String>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]
Get-CalendarDiagnosticLog -Identity <MailboxIdParameter> -MeetingID <String> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-LogLocation <String>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]

Detailed Description

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 Mailbox Permissions topic.

Parameters

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

MeetingID

Required

System.String

This parameter is reserved for internal Microsoft use.

Subject

Required

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.

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.

LogLocation

Optional

System.String

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

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.

Input Types

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.

Return Types

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.

Examples

EXAMPLE 1

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

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