Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05
Use the Remove-EmailAddressPolicy cmdlet to remove an existing e-mail address policy.
Syntax
Remove-EmailAddressPolicy -Identity
<EmailAddressPolicyIdParameter> [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter |
Use the Identity parameter to specify the GUID, distinguished name or e-mail address policy name that represents a specific e-mail address policy. You can also include the path by using the format Path\EmailAddressPolicy. You can omit the parameter label Identity so that only the e-mail address policy name or GUID is supplied. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller to be used for retrieving and writing data, include the DomainController parameter in the command. |
Detailed Description
The Remove-EmailAddressPolicy cmdlet removes an existing e-mail address policy and updates the recipients.
To run the Remove-EmailAddressPolicy 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
The following code is an example of the Remove-EmailAddressPolicy command. This example removes the e-mail address policy, Email_Address_Policy_1.
 Copy Code |
|
|---|---|
Remove-EmailAddressPolicy -Identity Email_Address_Policy_1 |
|