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