Export (0) Print
Expand All

Manage address lists

Exchange Online

Applies to: Exchange Online

Topic Last Modified: 2014-12-16

Address lists are a collection of mail-enabled objects in your organization. Mail-enabled objects are any object in your organization that has an email address. Each address list can contain one or more types of objects (for example, users, contacts, groups, public folders, and room and equipment mailboxes). Address lists also provide a way to partition mail-enabled objects for the benefit of specific groups of users. This topic explains how to manage address lists in Exchange Online.

For additional management tasks related to manage address lists, see Address list procedures in Exchange Online.

Looking for the Exchange 2013 version of this topic? See Create an address list.

  • 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 "Address lists" entry in the Email address and address book permissions topic.

  • By default, the Address List role isn’t assigned to any role groups. To use any cmdlets that require the Address List role, you need to add the role to a role group. For details, see the “Add a role to a role assignment policy” section of Manage role assignment policies.

  • You can’t use the EAC to perform these procedures. You must use the Shell.

  • For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection.

This example creates the address list MyAddressList by using the RecipientFilter parameter and includes recipients that are mailbox users and have StateOrProvince set to Washington or Oregon.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}

This example creates the child address list Building 34 Meeting Rooms in the All Rooms parent container, using built-in conditions.

New-AddressList -Name "Building 34 Meeting Rooms" -Container "\All Rooms" -IncludedRecipients Resources -ConditionalCustomAttribute1 "Building 34"

For detailed syntax and parameter information, see New-AddressList.

This example uses the address list's GUID to move the address list to the Building 4 container, which is located in the All Users\Sales container.

Move-AddressList -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -Target "\All Users\Sales\Building4"

Type Y to confirm that you want to move this address list, and then press ENTER.

For detailed syntax and parameter information, see Move-AddressList.

You apply an address list when the address list filter rule has been edited. To update the membership of the address list to include new recipients and remove those who no longer meet the filtering criteria, you must apply the address list.

Some address lists contain thousands or tens of thousands of recipients, depending on the size of your organization and the filters that you added to the address list. Updating large address lists can significantly impact your computers’ resources. In these cases, you may want to update the address lists during off-peak hours.

This example updates the address list Washington State.

Update-AddressList "Washington State"

If you have more than one address list with the same name, you must specify the full path to the address list you want to update. For example, if you want to update the address list Sales under North America, but there is also a Sales address list under Europe, use the following command:

Update-AddressList "North America\Sales"

For detailed syntax and parameter information, see Update-AddressList.

This example removes the address list Sales Department, which doesn't contain child address lists.

Remove-AddressList -Identity "Sales Department"

Type Y to confirm that you want to remove this address list, and then press ENTER.

For detailed syntax and parameter information, see Remove-AddressList.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft