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 Unlimitedlists every mail-enabled object.- Use
-RecipientTypeDetailsfor rooms, shared mailboxes, groups or guests. - Use
-Filter(OPATH) or-Anrto search. - Add
-Propertiesfor 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.