在Exchange Online中处理用户邮箱之外，还包括大量的其它收件对象。因此，无论是用户邮箱，还是资源邮箱、会议室邮箱、共享邮箱、联系人、通讯组等，在Exchange Online中都被定义为收件人。之前基本都是关于用户邮箱的各种Exchange Online PowerShell V2使用体验，接下来将对象的范围扩大到收件人这一层进行体验。
一、Get-EXORecipient命令
在Exchange Online PowerShell V2模块中获取邮箱对象和对应对象的属性，以及属性值，可以通过Get-EXORecipient（或EXORecipient）命令来实现。同时，该命令还可以为其它任务提供邮箱信息。
该命令的作用类似于旧版Exchange Online PowerShell的Get-Recipient命令的功能，但根据微软的介绍，提高了返回输出效率和扩展了功能。
默认返回所有已启用邮件的对象。包括：用户邮箱、邮件用户、邮件联系人、通讯组、共享邮箱、会议室邮箱、资源邮箱等等。
1、完整语法
EXORecipient
[-Filter <string>]/<string>
[-OrganizationalUnit <string>]/<string>
[-Properties <string>]/<string>
[-PropertySets <propertyset>]/<propertyset>
[-IncludeSoftDeletedRecipients]
[-RecipientType <string>]/<string>
[-RecipientTypeDetails <string>]/<string>
[[-Identity] <string>]/<string>
[-ExternalDirectoryObjectId <guid>]/<guid>
[-UserPrincipalName <string>]/<string>
[-ResultSize <unlimited>]/<unlimited>
[<commonparameters>]/<commonparameters>
或
EXORecipient
[-Anr <string>]/<string>
[-Filter <string>]/<string>
[-OrganizationalUnit <string>]/<string>
[-Properties <string>]/<string>
[-PropertySets <propertyset>]/<propertyset>
[-IncludeSoftDeletedRecipients]
[-RecipientType <string>]/<string>
[-RecipientTypeDetails <string>]/<string>
[-ResultSize <unlimited>]/<unlimited>
[<commonparameters>]/<commonparameters>
2、参数说明
Anr：
指定用于模糊查询的字符串。命令将返回在某些属性的值中包含该参数指定字符串的对象。具体参考Get-EXOCsaMailbox的Anr参数。
ExternalDirectoryObjectId：
指定Azure Active Directory中收件人的ObjectId标识来检索查找显示要查看的收件人。
具体参考Get-EXOCsaMailbox的ExternalDirectoryObjectId参数。
Filter：
使用OPath语法对查询的结果进行基于属性和属性值的筛选和查找。
具体参考Get-EXOCsaMailbox的Filter参数。
Identity：
指定查看的收件人。
具体参考Get-EXOCsaMailbox的Identity参数。
IncludeSoftDeletedRecipients：
指定返回被软删除的收件人。要执行该参数，必须要为组织管理员角色，或角色管理员角色。
其默认值为None。
OrganizationalUnit：
指定筛选对象所在AD中的OU名称。
具体参考Get-EXOCsaMailbox的OrganizationalUnit参数。
Properties：
指定命令返回输出的属性。
具体参考Get-EXOCsaMailbox的Properties参数。
PropertySet：
指定命令返回输出的属性逻辑集，该命令支持的有效值有：
- Minimum（该集合为命令默认输出）
- Archive
- Custom
- Policy
- MailboxMove
该参数默认为None。
RecipientType：
指定命令返回的结果按哪种收件人类型进行筛选，该参数的值可以是：
- DynamicDistributionGroup
- MailContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PublicFolder
- UserMailbox
该参数默认为None。
RecipientTypeDetails：
指定命令返回的结果按收件人的哪种子类型进行筛选，该参数的值剋是：
- DiscoveryMailbox
- DynamicDistributionGroup
- EquipmentMailbox
- GroupMailbox
- GuestMailUser
- LegacyMailbox
- LinkedMailbox
- LinkedRoomMailbox
- MailContact
- MailForestContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PublicFolder
- PublicFolderMailbox
- RemoteEquipmentMailbox
- RemoteRoomMailbox
- RemoteSharedMailbox
- RemoteTeamMailbox
- RemoteUserMailbox
- RoomList
- RoomMailbox
- SchedulingMailbox
- SharedMailbox
- TeamMailbox
- UserMailbox
该参数默认为None。
ResultSize：
指定要返回的最大查询条目数。
具体参考Get-EXOCsaMailbox的ResultSize参数。
UserPrincipalName：
指定要查看收件人的UPN。其默认值为None。
二、体验Get-EXORecipient
1、连接到Office 365的Exchange Online组织。
<code>Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China/<code>
2、直接使用默认参数值获取前1000个收件人对象的默认最小属性集
<code>Get-EXORecipient/<code>
3、获取所有收件人对象的默认最小属性集
<code>Get-EXORecipient -ResultSize Unlimited/<code>
4、获取指定收件人对象的最小属性集
<code>Get-EXORecipient zhangsan/<code>
5、获取邮件联系人类型的收件人属性信息
<code>Get-EXORecipient -RecipientType MailContact/<code>
6、获取共享邮箱子类的收件人属性信息
<code>Get-EXORecipient -RecipientTypeDetails SharedMailbox/<code>
閱讀更多 技術直通車 的文章
關鍵字: 收件人 之十 PowerShell
