Get-UMDialplan (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
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 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.
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