Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Get-UMActiveCalls

 

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.


Get-UMActiveCalls [-DomainController <Fqdn>] [-Server <ServerIdParameter>]


Get-UMActiveCalls -InstanceServer <UMServer> [-DomainController <Fqdn>]


Get-UMActiveCalls -DialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>]


Get-UMActiveCalls -IPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>]

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.

noteNote:
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.

 

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.

 

Error Description

 

 

 

Exceptions Description

 

 

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.

Get-UMActiveCalls

Get-UMActiveCalls -Server MyUMServer

Get-UMActiveCalls -IPGateway MyUMIPGateway

Get-UMActiveCalls -DialPlan MyUMDialPlan
To ensure that you are reading the most up-to-date information and to find additional Exchange Server 2007 documentation, visit the Exchange Server TechCenter.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.