Creating a Room Distribution List for Room Sync


The purpose of this Knowledge Base (KB) article is to walk through the setup of Room Distribution Lists (RDL) to work with the Vyopta Workspace Insights. 

Room Distribution Lists are different that O365 Groups. O365 Groups will NOT work.


The prerequisites to creating Room Distribution Lists are:

  1. Exchange Admin Rights
  2. Powershell with the ExchangeOnlineManagement Module if using Office 365.


1. Connecting to O365 Exchange Server:

Connect-ExchangeOnline -UserPrincipalName <Email Address>


Click To Enlarge

2. Now that the connection is established, we need to create the RDL by performing the following powershell command:

New-DistributionGroup -Name "Vyopta Rooms" -PrimarySmtpAddress "" -RoomList

The parameters:

-NameThe name you choose for your RDL - Must be unique

-PrimarySmtpAddressThe SMTP address for the room distribution list being created.

-RoomListThe RoomList parameter specifies that all the members in this list are room mailboxes. There is no value to put in, it's a switch.


3. The room mailboxes can now be added to the RDL.

To add a single room at a time, the following powershell command can be used:

Add-DistributionGroupMember -Identity "Vyopta Rooms" -Member "Room1"

The parameters:

-IdentityThe Identity parameter is the name of the RDL configured above

-Member The Member parameter is the name of the Room Mailbox we are adding


To add all the Room Mailboxes, the following powershell command can be used:

$Members=Get-Mailbox -Filter {(RecipientTypeDetails -eq "RoomMailbox")}
Add-DistributionGroupMember -Identity "Vyopta Rooms" -Members $Members

4. To verify the rooms are in the RDL, we can check what rooms are associated to that RDL group by running the following powershell command:

Get-DistributionGroupMember -Identity "Vyopta Rooms" | ft Name, PrimarySMTPAddress -AutoSize 


Converting A Distribution List to become a Room Distribution List

Let's say you created a distribution list already, and want to use that for Workspace Insights. Microsoft allows you to convert the DL to a RDL easily. The requirement for the DL is to have only Room Mailboxes. 

Once verified that the DL has no user mailboxes the following powershell command can be run:

Set-DistributionGroup -Identity "Vyopta Rooms" -RoomList
Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.