Skip to main content

​
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