Get-EXOMailboxFolderStatistics

此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块

使用 Get-EXOMailboxFolderStatistics cmdlet 检索有关指定邮箱中文件夹的信息,包括文件夹中的项目数和大小、文件夹名称和 ID 以及其他信息。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Get-EXOMailboxFolderStatistics
   [-Archive]
   [-DiagnosticInfo <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-Folderscope <ElcFolderType>]
   [-Identity <String>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-PrimarySmtpAddress <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

说明

邮箱可以包含用户永远看不到、只供应用程序使用的隐藏项。 Get-EXOMailboxFolderStatistics cmdlet 可以返回以下值的隐藏项目:FolderSize、FolderAndSubfolderSize、ItemsInFolder 和 ItemsInFolderAndSubfolders。

不要将Get-EXOMailboxFolderStatistics cmdlet (文件夹) 与Get-EXOMailboxStatistics cmdlet (邮箱) 混淆。

示例

示例 1

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com

此示例返回所有邮箱文件夹的统计信息。 默认值为 FolderScope All。

示例 2

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems

此示例仅返回日历文件夹的统计信息。

示例 3

Get-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxFolderStatistics -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize

此示例使用 FolderScope 参数查看所有邮箱的收件箱文件夹统计信息。

参数

-Archive

存档开关指定是否返回与邮箱或邮件用户关联的存档邮箱的使用情况统计信息。 不必为此开关指定值。

如果在未启用存档的邮箱上使用此开关,则会返回错误。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DiagnosticInfo

通常,仅应 Microsoft Customer Service 和 Support 的请求使用 DiagnosticInfo 参数来解决问题。 有效值包含:

  • ExternalDirectoryObjectId
  • 标识
  • UserPrincipalName
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExternalDirectoryObjectId

ExternalDirectoryObjectId 参数标识要通过 Azure Active Directory 中的 ObjectId 查看的邮箱。

不能将此参数与 Identity、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Folderscope

FolderScope 参数指定按文件夹类型搜索的作用域。 有效值包括:

  • 全部
  • 存档
  • 日历
  • 混乱邮件
  • 联系人
  • ConversationHistory
  • DeletedItems
  • 草稿
  • Inbox
  • 日志
  • JunkEmail
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • 注意
  • 发件箱
  • 个人
  • RecoverableItems
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • 任务
Type:ElcFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Identity 参数指定邮箱或邮件用户的标识。 为了获得最佳性能,我们建议使用用户 ID 或用户主体名称 (UPN) 来标识邮箱。

否则,可以使用唯一标识邮箱或邮件用户的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • LegacyExchangeDN
  • SamAccountName

不能将此参数与 ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-IncludeAnalysis

保留此参数以供 Microsoft 内部使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IncludeOldestAndNewestItems

IncludeOldestAndNewestItems 开关指定是否返回每个文件夹中最早和最新项目的日期。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IncludeSoftDeletedRecipients

IncludeSoftDeletedRecipients 开关指定是否在结果中包含软删除的邮箱。 不必为此开关指定值。

软删除的邮箱是已删除但仍可恢复的邮箱。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

PrimarySmtpAddress 按主 SMTP 电子邮件地址 (标识要查看的邮箱, navin@contoso.com 例如,) 。

不能将此参数与 ExternalDirectoryObjectId、Identity 或 UserPrincipalName 参数一起使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

UserPrincipalName 参数标识要由 UPN (查看的邮箱, navin@contoso.onmicrosoft.com 例如,) 。

不能将此参数与 ExternalDirectoryObjectId、Identity 或 PrimarySmtpAddress 参数一起使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online