在Exchange Online中处理用户邮箱之外,还包括大量的其它收件对象。因此,无论是用户邮箱,还是资源邮箱、会议室邮箱、共享邮箱、联系人、通讯组等,在Exchange Online中都被定义为收件人。之前基本都是关于用户邮箱的各种Exchange Online PowerShell V2使用体验,接下来将对象的范围扩大到收件人这一层进行体验。
在Exchange Online PowerShell V2模块中获取邮箱对象和对应对象的属性,以及属性值,可以通过Get-EXORecipient(或EXORecipient)命令来实现。同时,该命令还可以为其它任务提供邮箱信息。
该命令的作用类似于旧版Exchange Online PowerShell的Get-Recipient命令的功能,但根据微软的介绍,提高了返回输出效率和扩展了功能。
默认返回所有已启用邮件的对象。包括:用户邮箱、邮件用户、邮件联系人、通讯组、共享邮箱、会议室邮箱、资源邮箱等等。
1、完整语法
EXORecipient
[-Filter <String>]
[-OrganizationalUnit <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-IncludeSoftDeletedRecipients]
[-RecipientType <String[]>]
[-RecipientTypeDetails <String[]>]
[[-Identity] <String>]
[-ExternalDirectoryObjectId <Guid>]
[-UserPrincipalName <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
或
EXORecipient
[-Anr <String>]
[-Filter <String>]
[-OrganizationalUnit <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-IncludeSoftDeletedRecipients]
[-RecipientType <String[]>]
[-RecipientTypeDetails <String[]>]
[-ResultSize <Unlimited>]
[<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:
指定命令返回输出的属性逻辑集,该命令支持的有效值有:
该参数默认为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组织。
Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China
2、直接使用默认参数值获取前1000个收件人对象的默认最小属性集
3、获取所有收件人对象的默认最小属性集
Get-EXORecipient -ResultSize Unlimited
4、获取指定收件人对象的最小属性集
Get-EXORecipient zhangsan
5、获取邮件联系人类型的收件人属性信息
Get-EXORecipient -RecipientType MailContact
6、获取共享邮箱子类的收件人属性信息
Get-EXORecipient -RecipientTypeDetails SharedMailbox