共用方式為


Get-MailboxFolderStatistics

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。

使用 Get-MailboxFolderStatistics 指令碼來取得指定信箱中資料夾的資訊,包括資料夾中項目的數量與大小、資料夾名稱與 ID,以及其他資訊。

注意:在 PowerShell Exchange Online,我們建議你使用 Get-EXOMailboxFolderStatistics cmdlet 而非這個 cmdlet。 如需詳細資訊,請參閱<連線至 Exchange Online PowerShell>。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Identity

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

AuditLog

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

Database

Get-MailboxFolderStatistics
    -Database <DatabaseIdParameter>
    -StoreMailboxIdentity <StoreMailboxIdParameter>
    [-DiagnosticInfo <String>]
    [-FolderScope <ElcFolderType>]
    [-IncludeAnalysis]
    [-IncludeOldestAndNewestItems]
    [-IncludeSoftDeletedRecipients]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [<CommonParameters>]

Description

您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

信箱可能隱藏的項目,使用者永遠看不到,且只被應用程式使用。 Get-MailboxFolderStatistics 指令小檔可回傳以下數值的隱藏項目:FolderSize、FolderAndSubfolderSize、ItemsInFolder 以及 ItemsInFolderAndSubfolders。

Get-MailboxFolderStatistics 指令匣不應該和 Get-MailboxStatistics 指令匣混淆。

範例

範例 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

這個範例使用封存開關來查看艾拉檔案的統計資料。

範例 4

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

此範例使用 IncludeAnalysis 開關來查看 Tony 的 Recoverable Items 資料夾的統計資料。

範例 5

$All = Get-Mailbox -ResultSize Unlimited

$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize}

此範例使用 FolderScope 參數來查看所有信箱的收件匣資料夾統計資料。

參數

-Archive

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

封存開關會指定是否要回傳與該信箱或郵件使用者相關的歸檔使用統計資料。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AuditLog

適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

AuditLog
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Database

適用:Exchange Online

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

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

參數屬性

類型:DatabaseIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Database
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DiagnosticInfo

適用:Exchange Online

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

通常,只有在 Microsoft 客服與支援要求下,才會使用 DiagnosticInfo 參數來排除問題。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
AuditLog
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FolderScope

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

FolderScope 參數用來指定依資料夾類型進行搜尋的範圍。 有效的參數值包括:

  • 全部
  • 封存檔:Exchange 2016 或以後版本。
  • 行事曆
  • 聯絡人
  • 對話歷史
  • 刪除物品
  • 草稿
  • 收件匣
  • 垃圾郵件
  • 日誌
  • LegacyArchiveJournals:Exchange 2013 或之後。
  • ManagedCustomFolder:回傳所有受管理自訂資料夾的輸出。
  • NonIpmRoot:Exchange 2013 或之後版本。
  • 注意事項
  • 寄件匣
  • 個人版
  • RecoverableItems:回傳 Recoverable Items 資料夾及 Deletions、DiscoveryHolds、Purges 和 Versions 子資料夾的輸出。
  • RSS訂閱
  • 已發送物品
  • 同步問題
  • 工作

參數屬性

類型:ElcFolderType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。

參數屬性

類型:GeneralMailboxOrMailUserIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
AuditLog
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IncludeAnalysis

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

你應該用這個開關來進行故障排除,因為這個指令可能需要很長時間才能完成。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IncludeOldestAndNewestItems

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IncludeSoftDeletedRecipients

適用:Exchange Online

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

IncludeSoftDeletedRecipients 開關會指定是否包含軟刪除的信箱。 您不需要使用此參數指定值。

軟刪除的信箱是指仍可恢復的已刪除信箱。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用:Exchange Online

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

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

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SkipCount

適用:Exchange Online

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

{{ 填寫跳過計數描述 }}

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StoreMailboxIdentity

適用:Exchange Online

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

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

參數屬性

類型:StoreMailboxIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Database
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UseCustomRouting

適用:Exchange Online

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

{{ 填寫 UseCustomRouting 描述 }}

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

Input types

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

輸出

Output types

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