Export-ActiveSyncLog

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

The Export-ActiveSyncLog cmdlet parses the Internet Information Services (IIS) logs and returns information about Microsoft Exchange ActiveSync usage, either on the screen or in an output file.

Syntax

Export-ActiveSyncLog -Filename <FileInfo> [-Confirm [<SwitchParameter>]] [-EndDate <DateTime>] [-Force <SwitchParameter>] [-OutputPath <DirectoryInfo>] [-OutputPrefix <String>] [-StartDate <DateTime>] [-UseGMT <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detailed Description

The Export-ActiveSyncLog cmdlet parses the IIS log files and returns information about Exchange ActiveSync usage. This cmdlet can export the output to a file or display it in the Exchange Management Shell.

To run the Export-ActiveSyncLog cmdlet, the account you use must be delegated the Exchange Recipient Administrator role.

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Filename

Required

System.IO.FileInfo

This parameter specifies the Universal Naming Convention (UNC) path of the IIS logs.

EndDate

Optional

System.DateTime

This parameter specifies the end date of the date range of the report.

OutputPath

Optional

System.IO.DirectoryInfo

This parameter specifies the name and location for the output file.

OutputPrefix

Optional

System.String

This parameter specifies a prefix to append to the name of the output file.

StartDate

Optional

System.DateTime

This parameter specifies the start date of the date range for the report.

UseGMT

Optional

System.Management.Automation.SwitchParameter

This parameter specifies that Coordinated Universal Time (Greenwich Mean Time) will be used for the time in the report output. By default, if this parameter is not specified, local time will be used.

Confirm

Optional

System.Management.Automation.SwitchParameter

This parameter causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

Force

Optional

System.Management.Automation.SwitchParameter

This parameter suppresses the warning or confirmation messages that appear during specific configuration changes.

WhatIf

Optional

System.Management.Automation.SwitchParameter

This parameter instructs the command to simulate the actions that it would take on the object. By using this parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with this parameter.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

The following code example exports the Exchange ActiveSync log for the date range 06/08/06 to 06/09/06. The times on the report will be in Coordinated Universal Time (UTC), and the report will be saved in c:\Computer\Reports.

Export-ActiveSyncLog -FileName: "c:\Windows\System32\LogFiles\W2SVC1\ex060614.log" -StartDate:"06/08/06" -EndDate:"06/09/06" -UseGMT:$true -OutputPath:"c:\computer\reports"