Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11

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.


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


Parameter Required Type Description




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.




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

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 following:

  • Exchange View-Only Administrator role

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

Input Types

Return Types


Error Description




Exceptions Description




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.

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