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

Topic Last Modified: 2012-11-19

Use the Get-UMCallSummaryReport cmdlet to return statistics about all calls received or placed by Unified Messaging (UM) servers in an organization.

Syntax

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

Detailed Description

The Get-UMCallSummaryReport cmdlet displays the aggregated statistics about all calls received or placed by Unified Messaging servers 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 AggregateBy parameter is set to All, this column has the value ---.

  • If the AggregateBy parameter is set to Month, the date is in the format MMM/YY (for example, Jan/10), where:

    • MMM is the first three letters of the month.

    • YY is the last two digits of the corresponding year.

  • If the AggregateBy parameter is set to date, the date is in the format MM/DD/YY (for example, 01/23/10), where:

    • MM is the corresponding two digits of the month.

    • DD is the corresponding two digits of the day.

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 e-mail, 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 Unified Messaging 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 Unified Messaging servers 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 Unified Messaging servers 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.

Examples

EXAMPLE 1

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

Copy Code 
Get-UMCallSummaryReport -GroupBy Total

EXAMPLE 2

This example displays the statistics for all calls received or placed by Unified Messaging 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 Unified Messaging 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 Unified Messaging servers for the UM dial plan MyUMDialPlan.

Copy Code 
Get-UMCallSummaryReport -GroupBy Month -UMDialplan MyUMDialPlan