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