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

The Get-UMHuntGroup cmdlet displays the properties and values for an existing Unified Messaging (UM) hunt group.


Get-UMHuntGroup [-Identity <UMHuntGroupIdParameter>] [-DomainController <Fqdn>]


Parameter Required Type Description




To specify the fully qualified domain name 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 identifier for the UM hunt group that is being viewed. This is the directory object ID for the UM hunt group.

Detailed Description

The Get-UMHuntGroup cmdlet retrieves the properties for a single UM hunt group or a list of UM hunt groups. If only the UMIPGateway parameter is specified, the cmdlet will return all UM hunt groups that are associated with the UM IP gateway. If only the Identity parameter is specified, the properties for the UM hunt group are returned. If neither parameter is specified, all UM hunt groups in the Active Directory forest will be returned.

To run the Get-UMHuntGroup 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.

Input Types

Return Types


Error Description




Exceptions Description




The first example displays all the UM hunt groups in the Active Directory forest.

The second example displays the details of a UM Hunt Group named MyUMHuntGroup in a formatted list.

Copy Code

Get-UMHuntGroup -Identity MyUMHuntGroup | format-list