Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05
Use the Remove-DistributionGroup cmdlet to delete an existing distribution group from the Active Directory directory service.
Syntax
Remove-DistributionGroup -Identity
<DistributionGroupIdParameter> [-DomainController
<Fqdn>]
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter |
The Identity parameter specifies the distribution group that you want to remove. The Identity parameter can take any of the following values for the distribution group:
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory, include the DomainController parameter. |
Detailed Description
The Remove-DistributionGroup cmdlet deletes an existing distribution group from the Active Directory directory service.
To run the Remove-DistributionGroup cmdlet, the account you use must be delegated the following:
- Exchange Recipient Administrator role
- Account Operator role for the applicable Active Directory
containers
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
The following code example shows how to use the Remove-DistributionGroup cmdlet to remove an existing distribution group that is named Temporary Staff.
Copy Code | |
---|---|
Remove-DistributionGroup -Identity "Temporary Staff" |