Hiding recipients from address lists
There may be times when you'll need to hide a particular mailbox, contact, or distribution group from your Exchange address lists. This is a common task that is required when you have mailboxes, contacts, or public folders used by applications or staff in your IT department that should not be seen by end-users. In this recipe, we'll take a look at how you can disable these recipient types from the address lists using the Exchange Management Shell.
How to do it...
To hide a mailbox from the Exchange address lists, use the Set-Mailbox
command:
Set-Mailbox dave –HiddenFromAddressListsEnabled $true
How it works...
As you can see, hiding a mailbox from address lists is pretty straight forward as it requires only a simple PowerShell one-liner. The –HiddenFromAddressListsEnabled
parameter accepts a Boolean value, either $true
or $false
. To enable this setting, set the value to $true
, and to disable it, set the value to $false
.
There are multiple recipient types that can be hidden from address lists. Each of the following cmdlets supports the -HiddenFromAddressListsEnabled
parameter:
Set-DistributionGroup
Set-DynamicDistributionGroup
Set-Mailbox
Set-MailContact
Set-MailPublicFolder
Set-MailUser
Set-PublicFolder
Set-RemoteMailbox
There's more...
Once you've hidden your recipients from the address lists, you may need to generate a report to list the objects that currently have the HiddenFromAddressListsEnabled
setting enabled. Use the following command syntax to obtain this information:
Get-Mailbox -Filter {HiddenFromAddressListsEnabled -eq $true}
This searches for all mailboxes that have been hidden from address lists. It makes use of the –Filter
parameter which keeps you from having to perform the filtering on the client side with the Where-Object
cmdlet.
See also
- Working with recipient filters