Get-MailboxFolderStatistics

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Get-MailboxFolderStatistics Cmdlet 來擷取指定信箱中資料夾的相關資訊，包括資料夾中的專案數目和大小、資料夾名稱和識別碼，以及其他資訊。

注意：在 Exchange Online PowerShell 中，建議您使用 Get-EXOMailboxFolderStatistics Cmdlet，而不是此 Cmdlet。 如需詳細資訊，請參閱＜連線至 Exchange Online PowerShell＞。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-MailboxFolderStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   [[-Identity] <GeneralMailboxOrMailUserIdParameter>]
   [-AuditLog]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   -Database <DatabaseIdParameter>
   -StoreMailboxIdentity <StoreMailboxIdParameter>
   [-DiagnosticInfo <String>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

信箱可以有使用者永遠看不到且僅供應用程式使用的隱藏專案。 Get-MailboxFolderStatistics Cmdlet 可以傳回下列值的隱藏專案：FolderSize、FolderAndSubfolderSize、ItemsInFolder 和 ItemsInFolderAndSubfolders。

Get-MailboxFolderStatistics Cmdlet 不應與 Get-MailboxStatistics Cmdlet 混淆。

範例

範例 1

Get-MailboxFolderStatistics -Identity contoso\chris

此範例不會指定 FolderScope 參數，並擷取 Contoso 網域中使用者 Chris 的所有相關資訊。

範例 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

此範例會使用 FolderScope 參數來檢視使用者 Chris 行事曆資料夾的統計資料。

範例 3

Get-MailboxFolderStatistics -Identity Ayla@contoso.com -Archive

此範例會使用 [封存] 參數來檢視 Ayla 封存的統計資料。

範例 4

Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysis

此範例會使用 IncludeAnalysis 參數來檢視要復原的專案資料夾統計資料。

範例 5

$All = Get-Mailbox -ResultSize Unlimited

$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AuditLog

此參數僅適用於內部部署 Exchange。

將保留此參數供 Microsoft 內部使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Database

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

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

-DiagnosticInfo

此參數只能在雲端式服務中使用。

一般而言，您只會在客戶服務和支援Microsoft要求時使用 DiagnosticInfo 參數來針對問題進行疑難排解。

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

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-FolderScope

FolderScope 參數會依資料夾類型指定搜尋範圍。 有效的參數值包括：

  • 全部
  • 封存：Exchange 2016 或更新版本。
  • 行事曆
  • 聯絡人
  • ConversationHistory
  • DeletedItems
  • 草稿
  • 收件匣
  • 垃圾郵件
  • 日誌
  • LegacyArchiveJournals：Exchange 2013 或更新版本。
  • ManagedCustomFolder：傳回所有 Managed 自訂資料夾的輸出。
  • NonIpmRoot：Exchange 2013 或更新版本。
  • 注意事項
  • 寄件匣
  • 個人版
  • RecoverableItems：傳回 [可復原的專案] 資料夾和 Deletions、DiscoveryHolds、Purges 和 Versions 子資料夾的輸出。
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • 工作
Type:ElcFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity 參數會指定信箱或郵件使用者的識別碼。 您可以使用唯一識別信箱或郵件使用者的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeAnalysis

IncludeAnalysis 參數會指定是否要掃描資料夾內的所有專案，並傳回與資料夾和專案大小相關的統計資料。 您不需要使用此參數指定值。

您應該使用此參數進行疑難排解，因為命令可能需要很長的時間才能完成。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeOldestAndNewestItems

IncludeOldestAndNewestItems 參數會指定是否要傳回每個資料夾中最舊和最新專案的日期。 您不需要使用此參數指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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

-ResultSize

此參數只能在雲端式服務中使用。

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。

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

-SkipCount

此參數只能在雲端式服務中使用。

{{ Fill SkipCount Description }}

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

-StoreMailboxIdentity

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。