Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05
Use the Disable-MailContact cmdlet to remove the Exchange attributes of an existing mail-enabled contact in the Active Directory directory service. The contact object will remain in Active Directory but will no longer be mail-enabled.
Syntax
Disable-MailContact -Identity
<MailContactIdParameter> [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
The Identity parameter specifies the ADObjectID, distinguished name, GUID, or alias of the mail contact. |
|
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 in the command. |
Detailed Description
The Disable-MailContact cmdlet mail-disables an existing contact by removing the Exchange attributes of the contact. The contact is not deleted.
To run the Disable-MailContact cmdlet, the account you use must be delegated the following:
- Exchange Recipient 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 shows how to use the Disable-MailContact command to mail-disable a mail-enabled contact.
 Copy Code |
|
|---|---|
Disable-MailContact -Identity TedBremer |
|