体验O365中的EXO PS V2 之四 通过EXO 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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章