Applies to: Exchange Server 2013
Topic Last Modified: 2013-01-04
Recipient filtering is provided by the Recipient Filter agent. When recipient filtering is enabled on an Exchange server, it filters inbound messages that come from the Internet but aren't authenticated. These messages are handled as external messages.
What do you need to know before you begin?
- Estimated time to complete each procedure: 5 minutes
- You need to be assigned permissions before you can perform this
procedure or procedures. To see what permissions you need, see the
"Anti-spam features" entry in the Anti-Spam and
Anti-Malware Permissions topic.
- You can't use the Exchange admin center (EAC) to perform this
procedure. You can only use the Shell.
- By default, anti-spam features aren't enabled in the Transport
service on a Mailbox server. Typically, you only enable the
anti-spam features on a Mailbox server if your Exchange
organization doesn't do any prior anti-spam filtering before
accepting incoming messages. For more information, see Enable Anti-Spam
Functionality on a Mailbox Server.
- The AddressBookEnabled parameter on the
Set-AcceptedDomain cmdlet enables or disables recipient
filtering for recipients in an accepted domain. By default,
recipient filtering is enabled for authoritative domains, and
disabled for internal relay domains and external relay domains. To
view the status of the AddressBookEnabled parameter for the
accepted domains in your organization, run the following
command:
Copy Code Get-AcceptedDomain | Format-List Name,AddressBookEnabled
- If you disable recipient filtering using the procedure in this
topic, recipient filtering functionality will be disabled, but the
underlying Recipient Filter agent will remain enabled.
- 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?
Use the Shell to enable or disable recipient filtering
To disable recipient filtering, run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -Enabled $false |
To enable recipient filtering, run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -Enabled $true |
Note: |
---|
When you disable recipient filtering, the underlying Recipient
Filter agent is still enabled. To disable the Recipient Filter
agent, run the command: Disable-TransportAgent "Recipient
Filter Agent" . |
How do you know this worked?
To verify that you have successfully enabled or disabled recipient filtering, do the following:
- Run the following command:
Copy Code Get-RecipientFilterConfig | Format-List Enabled
- Verify the value displayed is the value you configured.
Use the Shell to enable or disable the Recipient Block list
Run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockListEnabled <$true | $false> |
This example enables the Recipient Block list:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockListEnabled $true |
How do you know this worked?
To verify that you have successfully enabled or disabled the Recipient Block list, do the following:
- Run the following command:
Copy Code Get-RecipientFilterConfig | Format-List BlockListEnabled
- Verify the value displayed is the value you configured.
Use the Shell to configure the Recipient Block list
To replace the existing values, run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockedRecipients <recipient1,recipient2...> |
This example configures the Recipient Block list with the valuesmark@contoso.com and kim@contoso.com:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockedRecipients mark@contoso.com,kim@contoso.com |
To add or remove entries without modifying any existing values, run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockedRecipients @{Add="<recipient1>","<recipient2>"...; Remove="<recipient1>","<recipient2>"...} |
This example adds chris@contoso.com to the list of recipients, and removes michelle@contoso.com from the list of recipients in the Recipient Block list:
Copy Code | |
---|---|
Set-RecipientFilterConfig -BlockedRecipients @{Add="chris@contoso.com"; Remove="michelle@contoso.com"} |
How do you know this worked?
To verify that you have successfully configured the Recipient Block list, do the following:
- Run the following command:
Copy Code Get-RecipientFilterConfig | Format-List BlockedRecipients
- Verify the values displayed are the values you configured.
Use the Shell to enable or disable Recipient Lookup
Run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -RecipientValidationEnabled <$true | $false> |
To block messages to recipients that don't exist in your organization, run the following command:
Copy Code | |
---|---|
Set-RecipientFilterConfig -RecipientValidationEnabled $true |
How do you know this worked?
To verify that you have successfully enabled or disabled Recipient Lookup, do the following:
- Run the following command:
Copy Code Get-RecipientFilterConfig | Format-List RecipientValidationEnabled
- Verify the value displayed is the value you configured.