New-DistributionGroup — usage, script and reference

Quick start script

# New-DistributionGroup — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-DistributionGroup
$before | Format-List

# 3. Make the change (dry run first)
New-DistributionGroup -Name <String> -WhatIf
New-DistributionGroup -Name <String>

# 4. Verify and diff
$after = Get-DistributionGroup
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

New-DistributionGroup [-Name] <String>
 [-Alias <String>]
 [-ArbitrationMailbox <MailboxIdParameter>]
 [-BccBlocked <Boolean>]
 [-BypassNestedModerationEnabled <Boolean>]
 [-Confirm]
 [-CopyOwnerToMember]
 [-Description <MultiValueProperty>]
 [-DisplayName <String>]
 [-DomainController <Fqdn>]
 [-HiddenGroupMembershipEnabled]
 [-IgnoreNamingPolicy]
 [-ManagedBy <MultiValuedProperty>]
 [-MemberDepartRestriction <MemberUpdateType>]
 [-MemberJoinRestriction <MemberUpdateType>]
 [-Members <MultiValuedProperty>]
 [-ModeratedBy <MultiValuedProperty>]
 [-ModerationEnabled <Boolean>]
 [-Notes <String>]
 [-OrganizationalUnit <OrganizationalUnitIdParameter>]
 [-PrimarySmtpAddress <SmtpAddress>]
 [-RequireSenderAuthenticationEnabled <Boolean>]
 [-RoomList]
 [-SamAccountName <String>]
 [-SendModerationNotifications <TransportModerationNotificationFlags>]
 [-Type <GroupType>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (27)

Parameter	Type	Required	What it controls
-Name	String	yes	The Name parameter specifies the unique name of the group. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
-Alias	String		The Alias parameter specifies the Exchange alias (also known as the mail nickname) for the recipient. This value identifies the recipient as a mail-enabled object, and shouldn't be confused with multiple email...
-ArbitrationMailbox	MailboxIdParameter		This parameter is available only in on-premises Exchange.
-BccBlocked	Boolean		This parameter is available only in the cloud-based service.
-BypassNestedModerationEnabled	Boolean		The ByPassNestedModerationEnabled parameter specifies how to handle message approval when a moderated group contains other moderated groups as members. Valid values are:
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-CopyOwnerToMember	SwitchParameter		The CopyOwnerToMember switch specifies whether group owners specified by the ManagedBy parameter are also members of the group. You don't need to specify a value with this switch.
-Description	MultiValuedProperty		This parameter is available only in the cloud-based service.
-DisplayName	String		The DisplayName parameter specifies the display name of the group. The display name is visible in the Exchange admin center and in address lists. The maximum length is 256 characters. If the value contains spaces,...
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-HiddenGroupMembershipEnabled	SwitchParameter		This parameter is available only in the cloud-based service.
-IgnoreNamingPolicy	SwitchParameter		The IgnoreNamingPolicy switch specifies whether to prevent this group from being affected by your organization's group naming policy. You don't need to specify a value with this switch.
-ManagedBy	MultiValuedProperty		The ManagedBy parameter specifies an owner for the group. A group must have at least one owner. If you don't use this parameter to specify the owner when you create the group, the user account that created the group...
-MemberDepartRestriction	MemberUpdateType		The MemberDepartRestriction parameter specifies the restrictions that you put on requests to leave the group. Valid values are:
-MemberJoinRestriction	MemberUpdateType		The MemberJoinRestriction parameter specifies the restrictions that you put on requests to join the group. Valid values are:
-Members	MultiValuedProperty		The Members parameter specifies the recipients (mail-enabled objects) that are members of the group. You can use any value that uniquely identifies the recipient. For example:
-ModeratedBy	MultiValuedProperty		The ModeratedBy parameter specifies one or more moderators for this group. A moderator approves messages sent to the group before the messages are delivered. A moderator must be a mailbox, mail user, or mail contact...
-ModerationEnabled	Boolean		The ModerationEnabled parameter specifies whether moderation is enabled for this recipient. Valid value are:
-Notes	String		The Notes parameters specifies additional information about the object. If the value contains spaces, enclose the value in quotation marks (").
-OrganizationalUnit	OrganizationalUnitIdParameter		The OrganizationalUnit parameter specifies the location in Active Directory where the group is created.
-PrimarySmtpAddress	SmtpAddress		The PrimarySmtpAddress parameter specifies the primary return email address that's used for the recipient.
-RequireSenderAuthenticationEnabled	Boolean		The RequireSenderAuthenticationEnabled parameter specifies whether to accept messages only from authenticated (internal) senders. Valid values are:
-RoomList	SwitchParameter		The RoomList switch specifies that all members of this distribution group are room mailboxes. You don't need to specify a value with this switch.
-SamAccountName	String		This parameter is available only in on-premises Exchange.
-SendModerationNotifications	TransportModerationNotificationFlags		The SendModerationNotifications parameter specifies when moderation notification messages are sent. Valid values are:
-Type	GroupType		The Type parameter specifies the type of group that you want to create. Valid values are:
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.