Skip to main content

Find-DistributionGroupMembers

SYNOPSIS​

Find members of distribution groups based on email address or domain.

SYNTAX​

Find-DistributionGroupMembers [[-FilterByDomain] <String>] [[-FilterByEmailAddresses] <String[]>]
 [-FilterByExternalDomains] [[-FilterRecipientTypeDetails] <String>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

DESCRIPTION​

This function retrieves members of all distribution groups in Exchange Online that match specified criteria such as email addresses or domains.

EXAMPLES​

EXAMPLE 1​

Find-DistributionGroupMembers -FilterByDomain "contoso.com"

Searches all distribution groups for members with email addresses containing "contoso.com" and exports the results to a CSV file.

EXAMPLE 2​

Find-DistributionGroupMembers -FilterByEmailAddresses "user@contoso.com"

Searches all distribution groups for members with the email address "user@contoso.com" and exports the results to a CSV file.

EXAMPLE 3​

Find-DistributionGroupMembers -FilterByExternalDomains -FilterRecipientTypeDetails "MailContact"

Searches all distribution groups for members whose email addresses belong to external domains and are of the type "MailContact", then exports the results to a CSV file.

PARAMETERS​

-FilterByDomain​

Specify a domain to filter distribution group members by their email addresses.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterByEmailAddresses​

Provide specific email addresses to filter distribution group members.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterByExternalDomains​

If set to true, filters members whose email addresses belong to external domains not managed in the Exchange Online environment (based on accepted domains).

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-FilterRecipientTypeDetails​

Specify a recipient type detail to further filter the members (e.g., MailContact, MailUser).

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

NOTES​