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.
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>]
|
Examples
EXAMPLE 1
This example retrieves the Calendar Diagnostic logs for Tony Smith's mailbox by using the subject Weekly development meeting.
 Copy Code |
|
|---|---|
Get-CalendarDiagnosticLog -Identity Tony -Subject "Weekly development meeting" |
|
EXAMPLE 2
This example retrieves the Calendar Diagnostic logs for Tony Smith's mailbox from 6/1/2012 to 6/30/2012.
| Copy Code |
|
|---|---|
Get-CalendarDiagnosticLog -Identity Tony -StartDate "6/1/2012 6:00:00 AM" -EndDate "6/30/2012 5:00:00 PM" |
|
EXAMPLE 3
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".
| Copy Code |
|
|---|---|
Get-CalendarDiagnosticLog -Identity Tony -Subject "Weekly development meeting" -Latest |
|
Detailed Description
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.
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:
|
|
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. |
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.