易宝典文章——体验O365中的EXO PS V2 之十 通过Exchange Online PowerShell V2获取收件人信息

clip_image002

在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>]

[-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:

指定命令返回输出的属性逻辑集,该命令支持的有效值有:

  • 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组织。

Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China

clip_image004

2、直接使用默认参数值获取前1000个收件人对象的默认最小属性集

Get-EXORecipientclip_image006

3、获取所有收件人对象的默认最小属性集

Get-EXORecipient -ResultSize Unlimited

clip_image008

4、获取指定收件人对象的最小属性集

Get-EXORecipient zhangsan

clip_image010

5、获取邮件联系人类型的收件人属性信息

Get-EXORecipient -RecipientType MailContact

clip_image012

6、获取共享邮箱子类的收件人属性信息

Get-EXORecipient -RecipientTypeDetails SharedMailbox

clip_image014