Get-EXOMailboxFolderStatistics
此 cmdlet 僅在 Exchange Online PowerShell 模組中提供。 欲了解更多資訊,請參閱「關於 Exchange Online PowerShell 模組」。
使用 Get-EXOMailboxFolderStatistics 指令碼來取得指定信箱中資料夾的資訊,包括資料夾中項目的數量與大小、資料夾名稱與 ID,以及其他資訊。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-EXOMailboxFolderStatistics
[-Archive]
[-DiagnosticInfo <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-IncludeAnalysis]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-PrimarySmtpAddress <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Description
信箱可能隱藏的項目,使用者永遠看不到,且只被應用程式使用。 Get-EXOMailboxFolderStatistics 指令小檔可回傳以下數值的隱藏項目:FolderSize、FolderAndSubfolderSize、ItemsInFolder 以及 ItemsInFolderAndSubfolders。
不要把 Get-EXOMailboxFolderStatistics cmdlet (資料夾) 和 Get-EXOMailboxStatistics cmdlet (mailboxes) 搞混。
範例
範例 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
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | 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 參數用來指定依資料夾類型進行搜尋的範圍。 有效值包括:
- 全部
- 封存
- 行事曆
- 雜亂資料
- 連絡人
- 對話歷史
- 刪除物品
- 草稿
- 收件匣
- 日誌
- 垃圾郵件
- 遺產檔案期刊
- ManagedCustomFolder
- NonIpmRoot
- 注意事項
- 寄件匣
- 個人版
- 可恢復項目
- RSS訂閱
- 已發送物品
- 同步問題
- 工作
參數屬性
| 類型: | ElcFolderType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Online
Identity 參數會指定信箱或郵件使用者的識別碼。 為了達到最佳效能,我們建議使用 UPN) (使用者 ID 或使用者主體名稱來識別信箱。
否則,你可以使用任何能唯一識別該信箱或使用者的值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- LegacyExchangeDN
- SamAccountName
你不能用這個參數搭配 ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 這些參數。
注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeAnalysis
適用:Exchange Online
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | 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。