Get-EXORecipient: List and Filter Exchange Online Recipients

2 min read James Futhey Updated November 13, 2026
Microsoft Learn documentation for the Get-EXORecipient cmdlet showing its PowerShell syntax

Quick answer: after Connect-ExchangeOnline, run Get-EXORecipient -ResultSize Unlimited to list every mail-enabled object: mailboxes, mail users, contacts and groups. Narrow it with -RecipientTypeDetails (for example RoomMailbox), -Filter or -Anr. Without -ResultSize, you get only 1,000 results.

What is Get-EXORecipient?

Get-EXORecipient is the Exchange Online module's REST-based version of Get-Recipient. It returns every mail-enabled object in the organization. It's available only in the Exchange Online PowerShell module, not on-premises Exchange.

Cmdlet Use it for
Get-EXORecipient Every recipient type in Exchange Online
Get-Recipient The same job in older scripts and on-premises Exchange
Get-EXOMailbox Mailboxes only, with mailbox properties
Get-EXORecipientPermission Send As permissions

How do I connect?

Install-Module ExchangeOnlineManagement -Scope CurrentUser
Connect-ExchangeOnline -UserPrincipalName admin@contoso.com

See installing the Exchange Online PowerShell module if the cmdlet isn't recognized.

How do I find one recipient?

Get-EXORecipient -Identity john@contoso.com
Get-EXORecipient -PrimarySmtpAddress john@contoso.com
Get-EXORecipient -Anr "john"

-Identity is fastest with a UPN or GUID, but accepts a name, alias or email address. -Anr does a partial match on name, display name, first name, last name and alias.

Watch out: an empty or $null -Identity returns every recipient, not an error.

How do I list recipients by type?

Get-EXORecipient -RecipientTypeDetails RoomMailbox -ResultSize Unlimited
Get-EXORecipient -RecipientTypeDetails SharedMailbox, UserMailbox -ResultSize Unlimited
Get-EXORecipient -RecipientTypeDetails GuestMailUser -ResultSize Unlimited
You want RecipientTypeDetails
User mailboxes UserMailbox
Shared mailboxes SharedMailbox
Meeting rooms RoomMailbox
Equipment EquipmentMailbox
Room lists RoomList
Microsoft 365 groups GroupMailbox
Distribution groups MailUniversalDistributionGroup
Mail-enabled security groups MailUniversalSecurityGroup
Dynamic distribution groups DynamicDistributionGroup
Guests GuestMailUser
Contacts MailContact

-RecipientType filters by the broader type. If you combine both, they must agree. For example, -RecipientType MailContact with -RecipientTypeDetails UserMailbox fails with "None of the specified RecipientTypeDetails are included in any specified recipient type."

How do I filter recipients?

-Filter uses OPATH syntax: "Property -Operator 'Value'".

Get-EXORecipient -Filter "DisplayName -like 'Conf*'" -ResultSize Unlimited
Get-EXORecipient -Filter "EmailAddresses -like '*@fabrikam.com'" -ResultSize Unlimited

Put text values in single quotes. Don't quote $true, $false, $null or numbers.

How do I get more properties?

Results use the Minimum property set by default. Ask for more with -PropertySets (Minimum, Archive, Custom, MailboxMove, Policy) or name properties with -Properties:

Get-EXORecipient -Identity john@contoso.com -Properties DisplayName, PrimarySmtpAddress, EmailAddresses, RecipientTypeDetails

Asking only for what you need keeps large queries fast.

How do I export recipients to CSV?

Get-EXORecipient -ResultSize Unlimited |
  Select-Object DisplayName, PrimarySmtpAddress, RecipientTypeDetails |
  Export-Csv .\recipients.csv -NoTypeInformation

To find soft-deleted recipients that can still be recovered, add -IncludeSoftDeletedRecipients.

Troubleshooting

Symptom Cause Fix
"Get-EXORecipient is not recognized" Module missing or not connected Install ExchangeOnlineManagement and run Connect-ExchangeOnline
Exactly 1,000 results Default ResultSize Add -ResultSize Unlimited
Every recipient returned when you expected one -Identity was empty or $null Check the variable before the call
A property is blank Not in the Minimum set Add -Properties or -PropertySets
RecipientTypeDetails error Conflicts with -RecipientType Drop one, or use matching values
Filter returns nothing Quoting Double quotes outside, single quotes around text values

Summary

  • Get-EXORecipient -ResultSize Unlimited lists every mail-enabled object.
  • Use -RecipientTypeDetails for rooms, shared mailboxes, groups or guests.
  • Use -Filter (OPATH) or -Anr to search.
  • Add -Properties for anything outside the Minimum set.
  • Default is 1,000 results.

Related: Get-EXOMailbox, Get-EXORecipientPermission, Install the Exchange Online module.

Meeting Room 365 turns any iPad or Android tablet into a room display for Exchange and Microsoft 365 calendars. See the features or pricing: $9 a display a month.

Add a display to your office

Every room, on the door.

Live availability on every meeting room. Works with Microsoft 365, Exchange and Google Workspace.