易宝典文章——体验O365中的EXO PS V2 之四 通过Exchange Online PowerShell V2获取邮箱信息

clip_image002

在Exchange Online的管理中,对于邮箱的管理基本会充斥着大多数的工作时间。接下来将体验使用Exchange Online PowerShell V2获取邮箱相关信息。

一、Get-EXOMailbox命令

在Exchange Online PowerShell V2模块中获取邮箱对象和对应对象的属性,以及属性值,可以通过Get-EXOMailbox(或EXOMailbox)命令来实现。同时,该命令还可以为其它任务提供邮箱信息。

该命令的作用类似于旧版Exchange Online PowerShell的Get-Mailbox命令的功能,但根据微软的介绍,提高了返回输出效率和扩展了功能。

默认返回组织中所有邮箱的摘要列表(最少属性集)。

1、完整语法

EXOMailbox

[[-Identity] <String>]

[-Archive]

[-ExternalDirectoryObjectId <Guid>]

[-Filter <String>]

[-InactiveMailboxOnly]

[-IncludeInactiveMailbox]

[-MailboxPlan <String>]

[-OrganizationalUnit <String>]

[-Properties <String[]>]

[-PropertySets <PropertySet[]>]

[-RecipientTypeDetails <String[]>]

[-ResultSize <Unlimited>]

[-SoftDeletedMailbox]

[-UserPrincipalName <String>]

[<CommonParameters>]

或:

EXOMailbox

[-Anr <String>]

[-Archive]

[-Filter <String>]

[-InactiveMailboxOnly]

[-IncludeInactiveMailbox]

[-MailboxPlan <String>]

[-OrganizationalUnit <String>]

[-Properties <String[]>]

[-PropertySets <PropertySet[]>]

[-RecipientTypeDetails <String[]>]

[-ResultSize <Unlimited>]

[-SoftDeletedMailbox]

[<CommonParameters>]

2、参数说明

Anr:

指定用于模糊查询的字符串。命令将返回在某些属性的值中包含该参数指定字符串的对象。具体参考Get-EXOCsaMailbox的Anr参数。

Archive:

指定返回启用的存档的邮箱。要执行该参数,必须要为组织管理员角色,或角色管理员角色。

其默认值为None。

ExternalDirectoryObjectId:

指定Azure Active Directory中邮箱的ObjectId标识来检索查找显示要查看的邮箱。

具体参考Get-EXOCsaMailbox的ExternalDirectoryObjectId参数。

Filter:

使用OPath语法对查询的结果进行基于属性和属性值的筛选和查找。

具体参考Get-EXOCsaMailbox的Filter参数。

MailboxPlan:

按邮箱计划筛选结果。指定该参数后,仅返回指定了邮箱计划的邮箱。其参数值可以为任何唯一标识邮箱计划的属性值。包括:

  • Name
  • Alias
  • Display Name
  • Distinguished Name(DN)
  • GUID

其默认值为None。

Identity:

指定查看的邮箱。

具体参考Get-EXOCsaMailbox的Identity参数。

InactiveMailboxOnly:

指定仅返回非活跃邮箱。要执行该参数,必须要为组织管理员角色,或角色管理员角色。非活跃邮箱是在软删除之前置于诉讼保留或就地保留的邮箱。其默认值为None。

IncludeInactiveMailbox:

指定返回活跃邮箱和非活跃邮箱。默认Get-EXOMailbox只返回活跃邮箱,需要同时返回非活跃邮箱,即需要使用该参数。要执行该参数,必须要为组织管理员角色,或角色管理员角色。其默认值为None。

OrganizationalUnit:

指定筛选对象所在AD中的OU名称。

具体参考Get-EXOCsaMailbox的OrganizationalUnit参数。

Properties:

指定命令返回输出的属性。

具体参考Get-EXOCsaMailbox的Properties参数。

PropertySet:

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

  • Minimum(该集合为命令默认输出)
  • AddressList
  • Audit
  • Archive
  • Custom
  • Delivery
  • Hold
  • Moderation
  • Move
  • Policy
  • PublicFolder
  • Quota
  • Resource
  • Retention
  • SCL
  • SoftDelete
  • StatisticsSeed
  • All

其默认值为None。

RecipientTypeDetails:

指定子类型返回邮箱,其参数值包括:

  • DiscoveryMailbox
  • EquipmentMailbox
  • GroupMailbox
  • LegacyMailbox
  • LinkedMailbox
  • LinkedRoomMailbox
  • RoomMailbox
  • SchedulingMailbox
  • SharedMailbox
  • TeamMailbox
  • UserMailbox

其默认值为None。

ResultSize:

指定要返回的最大查询条目数。

具体参考Get-EXOCsaMailbox的ResultSize参数。

SofteDeletedMailbox:

指定返回被软删除的邮箱。要执行该参数,必须要为组织管理员角色,或角色管理员角色。

其默认值为None。

UserPrincipalName:

指定要查看邮箱的UPN。其默认值为None。

二、体验Get-EXOMailbox

1、连接到Office 365的Exchange Online组织。

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

clip_image004

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

Get-EXOMailbox

clip_image006

3、获取指定用户的邮箱基本信息。

Get-EXOMailbox lisi

clip_image008

4、获取符合条件的指定条目数的对象。

Get-EXOMailbox -Anr “lpwr” -ResultSize 2

clip_image010

5、获取指定子类型的邮箱对象。

Get-EXOMailbox -RecipientTypeDetails SharedMailbox

clip_image012

该用法的结果实际与使用Filter参数针对邮箱对象的RecipientTypeDetails属性进行筛选SharedMailbox值等价。

Get-EXOMailbox -ResultSize Unlimited -Filter “RecipientTypeDetails -eq ‘SharedMailbox'”

clip_image014

通过逗号分隔可以同时指定多个子类型的邮箱对象被返回。

Get-EXOMailbox -RecipientTypeDetails RoomMailbox,EquipmentMailbox

clip_image016