Applies to: Exchange Server 2013

Topic Last Modified: 2012-06-29

Use the Get-UMCallSummaryReport cmdlet to return statistics about all calls received or placed by Mailbox server running the Microsoft Exchange Unified Messaging service in an organization.

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

Syntax


`Get-UMCallSummaryReport -GroupBy <Day \| Month \| Total> [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMIPGateway <UMIPGatewayIdParameter>]`

Examples

EXAMPLE 1

This example displays the statistics for all calls received or placed by Mailbox servers in the organization.

	Copy Code
Get-UMCallSummaryReport -GroupBy Total

EXAMPLE 2

This example displays the statistics for all calls received or placed by Mailbox servers in the organization over the last 12 months.

	Copy Code
Get-UMCallSummaryReport -GroupBy Month

EXAMPLE 3

This example displays the statistics for all calls received or placed by Mailbox servers in the organization over the last 90 days.

	Copy Code
Get-UMCallSummaryReport -GroupBy Day

EXAMPLE 4

This example displays the statistics for calls received or placed by Mailbox servers for the UM dial plan MyUMDialPlan.

	Copy Code
Get-UMCallSummaryReport -GroupBy Month -UMDialplan MyUMDialPlan

Detailed Description

The Get-UMCallSummaryReport cmdlet displays the aggregated statistics about all calls received or placed by Mailbox servers running the Microsoft Exchange Unified Messaging service in an organization including voice messages, missed calls, subscriber access, auto attendant, or fax calls. The data returned by running this cmdlet includes audio quality metrics for the sample calls such as the following:

Metrics	Description
Date	Date in which all calls associated with the selected UM IP gateway and UM dial plan have been grouped, as per the following: If the GroupBy parameter is set to `All`, this column has the value `---`. If the GroupBy parameter is set to `Month`, the date is in the format MMM/YY (for example, Jan/12), where MMM is the first three letters of the month and YY is the last two digits of the corresponding year. If the GroupBy parameter is set to `Date`, the date is in the format MM/DD/YY (for example, 01/23/12), where MM is the corresponding two digits of the month, DD is the corresponding two digits of the day, and YY is the last two digits of the corresponding year.
Voice Message	Percentage of incoming calls answered by Unified Messaging on behalf of users in which callers left a voice message.
Missed Calls	Percentage of incoming calls answered by Unified Messaging on behalf of users in which the callers didn't leave a voice message resulting in a missed call notification.
Outlook Voice Access	Percentage of incoming calls in which users authenticate to Unified Messaging to access their email, calendars, and voice messages.
Outbound	Percentage of calls placed or transferred by Unified Messaging on behalf of authenticated or unauthenticated users, which can be one of the following: Find Me Play On Phone Play On Phone Greetings
Automated Attendant	Percentage of incoming calls that were answered by auto attendants.
Fax	Percentage of incoming calls that were redirected to a fax partner.
Other	Percentage of any other incoming or placed calls that don't fall in any of the previous categories. This is provided to allow different types of calls that might be provided in the future to be accounted for as well. This category includes unauthenticated calls made to pilot numbers.
Failed Or Rejected	Percentage of calls that either failed or were rejected by the Mailbox server for that organization.
Audio Quality	Overall audio quality for the selected period of time for the organization/user using the following scale: Greater than 4.50 = Excellent From 3.5 through 4.49 = Good From 2.5 through 3.49 = Average From 1.50 through 2.49 =Poor Up to 1.49 = Bad
Total Calls	If the UM IP gateway is selected, this is the total number of calls grouped for the selected UM IP gateway for the corresponding date. If the UM dial plan control is selected, this is the total number of calls grouped for the selected UM dial plan for the corresponding date. If the user is selected, this column has the total number of calls for the user.
Network MOS (NMOS)	Average NMOS for the specific UM dial plan or UM IP gateway.
NMOS Degradation	NMOS degradation for the specific UM dial plan or UM IP gateway.
Jitter	Average jitter for the specific UM dial plan or UM IP gateway.
Packet loss	Average packet loss for the specific UM dial plan or UM IP gateway.
Round Trip	Round trip time (in milliseconds) for the selected UM dial plan or UM IP gateway.
Burst loss Duration	Average duration of packet loss during bursts of losses for the selected UM dial plan or UM IP gateway.
Number of samples	Number of calls sampled, when calculating the averages. A sample refers to any call data record that contains at least one of the audio quality metrics.

After this task is completed, a summary report will be displayed for all calls that are processed by Mailbox servers running the Microsoft Exchange Unified Messaging service in your organization.

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 "UM call data and summary reports" entry in the Unified Messaging Permissions topic.

Parameters

Parameter	Required	Type	Description
GroupBy	Required	Microsoft.Exchange.Data.GroupBy	The GroupBy parameter displays the daily statistics for the last 90 days, monthly statistics for the last 12 months, or a summary of all call statistics for your Mailbox servers running the Microsoft Exchange Unified Messaging service in your organization.
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.
Organization	Optional	Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter	The Organization parameter is reserved for internal Microsoft use.
UMDialPlan	Optional	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	The UMDialPlan parameter specifies the Unified Messaging (UM) dial plan to show statistics for. If you don't specify a dial plan, statistics are included for all dial plans in the organization.
UMIPGateway	Optional	Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter	The UMIPGateway parameter specifies the UM IP gateway to show statistics for. If you don't specify a UM IP gateway, statistics are included for all UM IP gateways for a selected dial plan, or, if no dial plan is selected, results will be returned for all UM IP gateways in the organization.

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.