Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-08-24

The Get-UMActiveCalls cmdlet returns information about the calls that are active and being processed by the Unified Messaging server.

Syntax

Get-UMActiveCalls [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-UMActiveCalls -InstanceServer <UMServer> [-DomainController <Fqdn>]
Get-UMActiveCalls -DialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>]
Get-UMActiveCalls -IPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>]

Parameters

Parameter Required Type Description

DialPlan

Required

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

This parameter specifies the UM dial plan for which you want to retrieve active calls.

InstanceServer

Required

Microsoft.Exchange.Data.Directory.Management.UMServer

This parameter specifies the Unified Messaging server for which you want to retrieve active calls.

IPGateway

Required

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

This parameter specifies the UM IP gateway for which you want to retrieve active calls.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

This parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory, include the DomainController parameter in the command.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

This parameter specifies the Unified Messaging server for which you want to retrieve active calls.

Detailed Description

The Get-UMActiveCalls cmdlet returns information about the active calls that are being processed. If the Get-UMActiveCalls cmdlet specifies either the UM dial plan or UM IP gateway, it will look in the Active Directory directory service to determine which Unified Messaging servers must be contacted. If the Unified Messaging server is specified in the command line, the Get-UMActiveCalls cmdlet returns the active calls that are being processed by the server that is specified.

Note:
When a Unified Messaging server is process cycling, the Get-UMActiveCalls cmdlet will not return a list of all calls for both the discontinued process and the active process. It will return the active calls only for the new process.

To run the Get-UMActiveCalls cmdlet, the account you use must be delegated the Exchange Server Administrator role and membership in the local Administrators group for the target server.

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

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

The first code example displays the details of all active calls on the local Unified Messaging server.

The second code example displays the details of all active calls on a Unified Messaging server named MyUMServer.

The third code example displays details of all active calls that are being processed by a UM IP gateway named MyUMIPGateway.

The fourth code example displays a list of active calls that are associated with the UM dial plan named MyUMDialPlan.

Copy Code
Get-UMActiveCalls

Get-UMActiveCalls -Server MyUMServer

Get-UMActiveCalls -IPGateway MyUMIPGateway

Get-UMActiveCalls -DialPlan MyUMDialPlan