之前已经体验过Exchange Online PowerShell V2怎样获取邮箱文件夹的权限。接下来将体验如何获取文件夹权限信息。
一、Get-EXOMailboxFolderStatistics命令
在Exchange Online PowerShell V2模块中获取邮箱中的文件夹级别信息,可以通过Get-EXOMailboxFolderStatistics(或EXOMailboxFolderStatistics)命令来实现。
该命令的作用类似于旧版Exchange Online PowerShell的Get-MailboxFolderStatistics命令的功能,但根据微软的介绍,提高了返回输出效率和扩展了功能。
默认返回指定邮箱文件夹的信息,包括文件夹中,项目的数量和大小、文件夹名称和ID以及其它信息。这些信息可能是对于用户不可见,仅提供给应用程序使用的隐藏项。
1、完整语法
EXOMailboxFolderStatistics
[-Archive]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-IncludeAnalysis]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-ResultSize <Unlimited>]
[-UserPrincipalName <String>]
[<CommonParameters>]
2、参数说明
ExternalDirectoryObjectId:
指定Azure Active Directory中邮箱的ObjectId标识来检索查找显示要查看的邮箱。
具体参考Get-EXOCsaMailbox的ExternalDirectoryObjectId参数。
FolderScope:
指定按文件夹类型作为作用域,搜索的结果只显示该类型的文件夹。其参数值包括:
- All
- Archive
- Calendar
- Clutter
- Contacts
- ConversationHistory
- DeletedItems
- Drafts
- Inbox
- Journal
- JunkEmail
- LegacyArchiveJournals
- ManagedCustomFolder
- NonlpmRoot
- Notes
- Outbox
- Personal
- RecoverableItems
- RssSubscriptions
- SentItems
- Synclssues
- Tasks
其默认值为None。
Identity:
指定要产看的邮箱或邮件用户,可以是邮箱或邮件用户的任何唯一标识值。
具体参考Get-EXOCsaMailbox的Identity参数。
根据当前的预览版体验来看,该参数为必填参数。
ResultSize:
指定要返回的最大查询条目数。
具体参考Get-EXOCsaMailbox的ResultSize参数。
Includenalysis:
指定是否扫描文件夹中的所有项目,并返回与该文件夹和项目大小相关的统计信息。
该参数在目前的预览版中不可用。其默认值为None。
IncludeOldestAndNewestItems:
指定是否返回每个文件夹中最旧项目和最新项目的日期。要执行该参数,必须要为组织管理员角色,或角色管理员角色。
其默认值为None。
IncludeSoftDeletedRecipients:
指定是否在结果中包括软删除的邮箱。要执行该参数,必须要为组织管理员角色,或角色管理员角色。
该参数在目前的预览版中不可用。其默认值为None。
Archive:
指定是否返回与邮箱或邮件用户关联的存储邮箱的使用情况统计信息。要执行该参数,必须要为组织管理员角色,或角色管理员角色。
其默认值为None。
UserPrincipalName:
指定要查看邮箱的UPN。其默认值为None。
二、体验Get-EXOMailboxFolderStatistics
1、连接到Office 365的Exchange Online组织。
Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China
2、获取指定用户邮箱的各文件夹状态信息
Get-EXOMailboxFolderStatistics [email protected]
该命令将显示指定用户的所有文件夹状态信息,通常数量会非常多,因此更多的操作时会对其进行范围缩小。
3、获取指定用户邮箱中某类文件夹的状态信息
可以使用Folderscope参数根据文件夹的功能和作用筛选出具有某类功能或作用的文件夹。
Get-EXOMailboxFolderStatistics [email protected] -Folderscope Inbox
4、获取指定用户邮箱中指定名称的文件夹状态信息
结合PowerShell的Where-Object筛选命令,可以在返回结果中进行筛选指定名称(Name)的文件夹,以进行精确定位。
Get-EXOMailboxFolderStatistics [email protected] | Where-Object {$_.Name -eq “重要邮件”}
5、获取指定用户邮箱中特定路径的文件夹状态信息
如果在不同的父文件夹下,存在同名的子文件夹,那么通过名称来筛选的方式将不能准确进行定位目标文件夹。
此时,需要采用文件夹路径(FolderPath)进行定位的方式进行筛选。
Get-EXOMailboxFolderStatistics [email protected] | Where-Object {$_.FolderPath -eq “/收件箱/财务部门/部门通知”}
6、获取指定用户收件箱中最新邮件和最旧邮件的接收日期
Get-EXOMailboxFolderStatistics [email protected] -IncludeOldestAndNewestItems | Where-Object {$_.Name -eq “收件箱”}