Applies to: Exchange Server 2007
Topic Last Modified: 2007-08-09
The Remove-UMHuntGroup cmdlet removes and deletes an existing Unified Messaging (UM) hunt group.
Syntax
Remove-UMHuntGroup -Identity
<UMHuntGroupIdParameter> [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.UMHuntGroupIdParameter |
This parameter specifies the identifier for the UM hunt group that is being deleted. This is the directory object ID for the UM hunt group object. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller that writes this configuration change to Active Directory, include the DomainController parameter on the cmdlet. |
Detailed Description
The Remove-UMHuntGroup cmdlet deletes an existing UM hunt group from the Active Directory directory service. When the Remove-UMHuntGroup cmdlet is used, the UM hunt group is removed from the UM IP gateway and then deleted from Active Directory. If the operation leaves the UM IP gateway without any remaining configured UM hunt groups, the IP gateway will be unable to handle or process UM calls.
To run the Remove-UMHuntGroup cmdlet, the account you use must be delegated the following:
- Exchange Organization 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
Errors
| Error | Description |
|---|---|
|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
|
Example
This example deletes a UM hunt group named MyUMHuntGroup.
 Copy Code |
|
|---|---|
Remove-UMHuntGroup -Identity MyUMHuntGroup |
|