Add-DistributionGroupMember cmdlet enables to add a new specified member(s) to the distribution group. Only mail-enabled member can be added to the group.

The following members can be added to the distribution group:

  • Distribution Lists
  • Mailboxes (Exchange, OWA-only, POP/IMAP, Resource mailbox)
  • Mail contacts
  • Public folders

Input parameters

#
Parameter
Type

Mandatory (R/O)

Description
Valid Values
1 Authentication Information (all parameters)  
2

Identity

(aliases: GUID, DistinguishedName)

ADObjectIDParameter R

A property, that specifies the group for managing the members of the distribution group (list)

Value of one of these parameters can be used as Identity:

#ParameterDescription
1 GUID Globally Unique Identifier (ObjectGuid)
2 DistinguishedName Unique name of the object in Active Directory
3

Member

(alias: Members)

ADObjectIDParameter[] R

Identity of the object(s), which will be added to the distribution group

Mail-enabled objects:

  • Exchange
  • OWA-only
  • POP/IMAP mailbox
  • Resource mailbox
  • Contact
  • Public folder
  • Distribution list

Value of one of these parameters can be used as m ember's identity:

  • GUID
  • DistinguishedName

Output parameters

No parameters

Examples of using Add-DistributionGroupMember cmdlet

Adding one member to the distribution group (list) by DistinguishedName:

Add-DistributionGroupMember -Identity "CN=DL@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local" -Member "CN=test@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local"

Adding one member to the distribution group (list) by GUID:

Add-DistributionGroupMember -Identity "CN=DL@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local" -Member "33FDAB33-766F-4D40-94C7-61177BFCAE50"

Adding several members to the distribution group (list) :

Add-DistributionGroupMember -Identity "CN=DL@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local" -Members "CN=test@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local","87C213E7-ACE7-43DE-8D06-D75101CD621C"