Share via


Get-UMDialplan

 

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

The Get-UMDialplan cmdlet displays the properties of a single Unified Messaging (UM) dial plan, or returns a list of all UM dial plans associated with a Unified Messaging server.

Syntax

Get-UMDialPlan [-Identity <UMDialPlanIdParameter>] [-DomainController <Fqdn>]

Detailed Description

The Get-UMDialplan cmdlet lets you view all properties for a UM dial plan. This cmdlet can be executed to view the values set. When the Get-UMDialplan cmdlet is run, if no parameter is supplied, the cmdlet will return all UM dial plans in the Active Directory forest.

To run the Get-UMDialplan cmdlet, the account you use must be delegated the Exchange View-Only 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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the cmdlet.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

This parameter specifies the UM dial plan ID. This parameter specifies the directory object identifier for the UM dial plan.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

The first code example displays a list of all the UM dial plans in the Active Directory forest.

The second code example displays a formatted list of properties for a UM dial plan named MyUMDialPlan.

Get-UMDialPlan -Identity MYDomainDialPlan
Get-UMDialPlan -Identity MyUMDialPlan | format-list