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