hands-on lab

Managing Distribution Lists Using Exchange Online PowerShell

Up to 45m
This lab is currently under maintenance. You can start the lab, but some instructions and screenshots may be inaccurate. We are actively working to resolve this issue and we apologize for any inconvenience.

Microsoft has currently disabled new registrations for the MS 365 Dev program. For the time being, please treat the lab as read-only or bring your own MS 365 account. Our team is currently working on an update, thank you for your understanding.

Get guided in a real environmentPractice with a step-by-step scenario in a real, provisioned environment.
Learn and validateUse validations to check your solutions every step of the way.
See resultsTrack your knowledge and monitor your progress.


Exchange Online PowerShell lets you manage your Exchange Online mailboxes from the command line. You can use Exchange Online PowerShell to manage distribution lists where users can send emails to multiple recipients in one go, without having to type in each individual address. Distribution lists are commonly used to distribute messages to a group of email addresses of users who share a common property, such as being part of the same department or project.

In this lab, you will create a new distribution list and adjust the members of the distribution list.

Note: Due to this lab requiring the use of a Microsoft 365 organization with an Admin Center, if you don't already have access to one you will need to provide a mobile phone number to pass the account creation process.

Learning Objectives

Upon completion of this lab, you will be able to:

  • Create and remove distribution lists from Exchange Online using the Exchange Online PowerShell module
  • Adjust distribution list membership

Intended Audience

  • Microsoft 365 System Administrators interested in scripting to automate and speed up the management of distribution lists in Exchange Online
  • IT Support Analysts  


Familiarity with the following is recommended:

  • PowerShell

The following content can be used to fulfill the prerequisite:


November 30th, 2022 - Updated the instructions and screenshots to reflect the latest UI

About the author

Adil Islam, opens in a new tab
Cloud Labs Developer
Learning paths

Adil is a Microsoft Certified Trainer, former Azure Engineer, and loves all things Azure. He is a certified Azure Administrator and Azure DevOps Expert and has worked for some of the biggest MSPs in the world (Cognizant, New Signature, CoreAzure). He loves to combine his two passions: cloud and teaching.

Adil specializes in Azure Infrastructure services and has a curiosity for new, in-preview services from Azure, getting his hands familiar with the content before most of the world does. Outside of work, Adil helps run a growing community of IT professionals looking to break into the cloud and regularly runs workshops and webinars.

Covered topics

Lab steps

Setting Up A Microsoft 365 Developer Account
Connecting to Exchange Online PowerShell
Managing Distribution Lists Using Exchange Online PowerShell