Skip to content

Get-DL

SYNOPSIS

Retrieve distribution lists (DLs) in Exchange Online.

SYNTAX

Identity (Default)

Get-DL [[-Identity] <String[]>] [[-Member] <String[]>] [<CommonParameters>]

ANR

Get-DL [-Search] <String[]> [<CommonParameters>]

DESCRIPTION

The `Get-DL` function retrieves distribution lists (DLs) in Exchange Online. It supports searching by identity, approximate name resolution (ANR), or filtering by members. The function connects to Exchange Online and uses the `Get-DistributionGroup` and `Get-Recipient` cmdlets to fetch the data.

EXAMPLES

EXAMPLE 1

Get-DL -Identity "DL-Sales"

Retrieves the distribution list with the identity `DL-Sales`.

EXAMPLE 2

Get-DL -Search "Sales"

Retrieves distribution lists matching the search string `Sales`.

EXAMPLE 3

Get-DL -Member "[email protected]"

Retrieves distribution lists that include `user@example.com` as a member.

PARAMETERS

-Identity

The identity of the distribution list(s) to retrieve.

Type: String[]
Parameter Sets: Identity
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Search

A search string for approximate name resolution (ANR) to find distribution lists.

Type: String[]
Parameter Sets: ANR
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Member

A list of members to filter the distribution lists by.

Type: String[]
Parameter Sets: Identity
Aliases:

Required: False
Position: 2
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