Get-EXOMailboxFolderStatistics
此 Cmdlet 僅適用於 Exchange Online PowerShell 模組。 如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。
使用 Get-EXOMailboxFolderStatistics Cmdlet 擷取指定信箱中資料夾的相關資訊，包括資料夾中項目的數目和大小、資料夾名稱和識別碼以及其他資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-EXOMailboxFolderStatistics
[-Archive]
[-DiagnosticInfo <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-PrimarySmtpAddress <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Description
信箱可以包含使用者永遠不會看見且僅供應用程式使用的隱藏項目。 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
適用：Exchange Online
封存參數會指定是否要傳回與信箱或郵件使用者相關聯之封存信箱的使用統計資料。 您不需要使用此參數指定值。
如果您在未啟用封存的信箱上使用此參數，則會傳回錯誤。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagnosticInfo
適用：Exchange Online
注意：此參數在模組版本 3.7.0-Preview1 或更新版本中已過時。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExternalDirectoryObjectId
適用：Exchange Online
ExternalDirectoryObjectId 參數會識別您想要依 Microsoft Entra ID 中的 ObjectId 檢視的信箱。
您無法將此參數與 Identity、PrimarySmtpAddress 或 UserPrincipalName 參數搭配使用。
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Folderscope
適用：Exchange Online
FolderScope 參數會依資料夾類型指定搜尋的範圍。 有效值包括：
- 全部
- 封存
- 行事曆
- 雜亂資料
- 連絡人
- ConversationHistory
- DeletedItems
- 草稿
- 收件匣
- 日誌
- JunkEmail
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- 注意事項
- 寄件匣
- 個人版
- RecoverableItems
- RssSubscriptions
- SentItems
- SyncIssues
- 工作
參數屬性
| 類型: | ElcFolderType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Online
Identity 參數會指定信箱或郵件使用者的識別碼。 為獲得最佳效能，建議您使用 UPN) (使用者識別碼或使用者主體名稱來識別信箱。
否則，您可以使用唯一標識信箱或郵件使用者的任何值。 例如：
- 名稱
- 別名
- 辨別名稱 (DN)
- LegacyExchangeDN
- SamAccountName
您無法將此參數與 ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 參數搭配使用。
警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeOldestAndNewestItems
適用：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 |
-PrimarySmtpAddress
適用：Exchange Online
PrimarySmtpAddress 會依主要 SMTP 電子郵件地址識別您想要檢視的信箱 (例如 navin@contoso.com) 。
您無法將此參數與 ExternalDirectoryObjectId、Identity 或 UserPrincipalName 參數搭配使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UserPrincipalName
適用：Exchange Online
UserPrincipalName 參數會識別您要透過 UPN (檢視的信箱，例如 navin@contoso.onmicrosoft.com) 。
您無法將此參數與 ExternalDirectoryObjectId、Identity 或 PrimarySmtpAddress 參數搭配使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。