Applies to: Exchange Server 2013
Topic Last Modified: 2012-12-05
You can disable email for an existing mail contact in your Exchange organization. When you disable email for a mail contact, it's removed from Exchange and from your organization's address book. If the mail contact is a member of a distribution group, the contact no longer receives mail sent to the group. Also, the Exchange attributes are removed from the mail-enabled contact object in Active Directory, but the contact and its non-Exchange attributes (such as contact and organization information) are retained in Active Directory.
After you disable email for a mail contact, you can mail-enable the contact again by using the Enable-MailContact cmdlet in the Shell. You can also use this cmdlet to mail-enable any Active Directory contact.
For additional management tasks related to mail contacts, see Manage Mail Contacts.
What do you need to know before you begin?
- Estimated time to complete each procedure: 2 minutes.
- You need to be assigned permissions before you can perform this
procedure or procedures. To see what permissions you need, see the
"Mail contacts" entry in the Recipients
Permissions topic.
- For information about keyboard shortcuts that may apply to the
procedures in this topic, see Keyboard Shortcuts in
the Exchange Admin Center.
Tip: |
---|
Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection. |
What do you want to do?
Disable email for a mail contact
As previously stated, when you disable email for a mail contact, the Exchange attributes are removed from the corresponding Active Directory contact object, but the contact is retained. The mail contact is removed from the list of mail contacts in the EAC, but you can view and manage the corresponding Active Directory contact object by using Active Directory Users and Computers or by using the Get-Contact and Set-Contact cmdlets in the Shell.
Use the EAC to disable email for a mail contact
- In the EAC, navigate to Recipients
> Contacts.
- In the list of contacts, click the mail contact for which you
want to disable email.
- Click More and then click Disable.
- A warning will appear asking if you're sure you want to disable
the selected mail contact. Click Yes to disable it.
The mail contact will be removed from the contacts list.
Use the Shell to disable email for a mail contact
This example disables email for the mail contact Neil Black.
Copy Code | |
---|---|
Disable-MailContact -Identity "Neil Black" |
For detailed syntax and parameter information, see Disable-MailContact.
How do you know this worked?
To verify that you’ve successfully disabled email for a mail contact, do one of the following:
- In the EAC, navigate to
Recipients > Contacts and verify that
the mail contact is no longer listed.
- In Active Directory Users and Computers, right-click the
contact, and then click Properties. On the General
tab, notice that the E-mail box is blank. This verifies that
the contact isn't mail-enabled.
- In the Shell, run the following command.
Copy Code Get-MailContact
- In the Shell, run the following command.
Copy Code Get-Contact
Use the Shell to mail-enable contacts
You can use the Enable-MailContact cmdlet to mail-enable existing Active Directory contacts. You can mail-enable a single contact or use a CSV file to mail-enable multiple contacts.
Use the Shell to mail-enable a single contact
This example mail-enables the contact Rene Valdes. You must provide an external email address.
Copy Code | |
---|---|
Enable-MailContact -Identity "Rene Valdes" -ExternalEmailAddress renev@tailspintoys.com |
Use the Shell and a CSV file to mail-enable multiple contacts
When you’re mail-enabling contacts in bulk, you first export the list of contacts that aren’t mail-enabled to a CSV (comma-separated values) file, and then add the external email addresses to the CSV file by using a text editor such as Notepad, or a spreadsheet application such as Microsoft Excel. Then you use the updated CSV file in the Shell command to mail-enable the contacts listed in the CSV file.
- Run the following command to export a list of existing contacts
that aren't mail-enabled to a file on the administrator's desktop
named Contacts.csv.
Copy Code Get-Contact | Where { $_.RecipientType -eq "Contact" } | Out-File "C:\Users\Administrator\Desktop\Contacts.csv"
Copy Code Name Walter Harp James Alvord Rainer Witt Susan Burk Ian Tien ...
- Add a column heading named EmailAddress and then add an
email address for each contact in the file. The name and external
email address for each contact must be separated by a comma. The
updated CSV file should look similar to the following file.
Copy Code Name,EmailAddress James Alvord,james@contoso.com Susan Burk,sburk@tailspintoys.com Walter Harp,wharp@tailspintoys.com Ian Tien,iant@tailspintoys.com Rainer Witt,rainerw@fourthcoffee.com ...
- Run the following command to use the data in the CSV file to
mail-enable the contacts listed in the file.
Copy Code Import-CSV C:\Users\Administrator\Desktop\Contacts.csv | ForEach-Object {Enable-MailContact -Identity $_.Name -ExternalEmailAddress $_.EmailAddress}
How do you know this worked?
To verify that you’ve successfully mail-enabled Active Directory contacts, do one of the following:
- In the EAC, navigate to
Recipients > Contacts. New mail contacts
are displayed in the contact list. Under Contact Type, the
type is Mail contact.
Note: You may have to click Refresh to display new mail contacts. - In the Shell, run the following command to display information
about new mail contacts.
Copy Code Get-MailContact | Format-Table Name,RecipientTypeDetails,ExternalEmailAddress