Get-UMHuntGroup

 

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

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

Syntax

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

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.

Parameters

Parameter	Required	Type	Description
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	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.
Identity	Optional	Microsoft.Exchange.Configuration.Tasks.UMHuntGroupIdParameter	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.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

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.

Get-UMHuntGroup

Get-UMHuntGroup -Identity MyUMHuntGroup | format-list