体验O365中的EXO PS V2 之四 通过EXO PowerShell V2获取邮箱信息

在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 admin@lpwr.net -ExchangeEnvironmentName O365China

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

Get-EXOMailbox

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

Get-EXOMailbox lisi

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

Get-EXOMailbox -Anr "lpwr" -ResultSize 2

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

Get-EXOMailbox -RecipientTypeDetails SharedMailbox

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

Get-EXOMailbox -ResultSize Unlimited -Filter "RecipientTypeDetails -eq 'SharedMailbox'"

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

Get-EXOMailbox -RecipientTypeDetails RoomMailbox,EquipmentMailbox