Get-MailboxStatistics
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 Get-MailboxStatistics 指令碼來回傳信箱資訊，例如信箱大小、包含的訊息數量，以及最後一次存取的時間。 此外，你還可以取得完成搬遷請求的搬遷歷史或搬遷報告。
注意：在 PowerShell Exchange Online，我們建議你使用 Get-EXOMailboxStatistics cmdlet 而非這個 cmdlet。 如需詳細資訊，請參閱＜連線至 Exchange Online PowerShell＞。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Database
Get-MailboxStatistics
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Identity
Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[-UseCustomRouting]
[<CommonParameters>]
Server
Get-MailboxStatistics
-Server <ServerIdParameter>
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludePassive]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Description
只有在 Mailbox 伺服器上，你可以在沒有參數的情況下使用 Get-MailboxStatistics 指令。 此時，指令檔會回傳本地伺服器上所有資料庫中所有信箱的統計資料。
Get-MailboxStatistics 指令小程式至少需以下一項參數才能成功完成：伺服器、資料庫或身份。
你可以使用 Get-MailboxStatistics 指令碼來回傳詳細的移動歷史和已完成的移動請求的搬遷報告，以排解搬遷請求的故障。 要查看移動歷史，必須將此 cmdlet 當作物件傳遞。 搬遷歷史會保留在信箱資料庫中，並以遞增方式編號，而最後執行的搬遷請求總是編號為 0。 更多資訊請參閱本文中的「範例7」、「範例8」及「範例9」。
你只能看到已完成搬遷請求的搬遷報告和搬遷歷史。
注意：我們將棄用 Exchange Online PowerShell 中的 LastUserActionTime 屬性。 不要把該房產的價值當作信箱最後啟用時間。
您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-MailboxStatistics -Identity AylaKol
此範例透過使用者 Ayla Kol 的相關別名 AylaKol 取得其信箱的統計數據。
範例 2
Get-MailboxStatistics -Server MailboxServer01
此範例取得伺服器 MailboxServer01 上所有信箱的統計資料。
範例 3
Get-MailboxStatistics -Identity contoso\chris
此範例取得指定信箱的信箱統計資料。
範例 4
Get-MailboxStatistics -Database "Mailbox Database"
此範例取得指定信箱資料庫中所有信箱的統計資料。
範例 5
Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'
此範例取得組織內所有信箱資料庫中斷開信箱的信箱統計數據。 -ne 算符表示不等。
範例 6
Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d
此範例取得單一斷線信箱的統計資料。 StoreMailboxIdentity 參數的值是斷線信箱的信箱 GUID。 你也可以使用 LegacyDN。
範例 7
Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List
此範例回傳完成搬遷請求的摘要，該請求為 Ayla Kol 的信箱。 如果你沒有將輸出管線化到 Format-List 指令匣，移動歷史就不會顯示。
範例 8
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]
此範例回傳 Ayla Kol 郵箱已完成搬遷請求的詳細移動歷史。 此範例使用暫存變數來儲存 mailbox 統計物件。 如果信箱被移動多次，會有多個搬遷報告。 最後的行動報告永遠是 MoveReport[0]。
範例 9
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv
此範例會回傳詳細的移動歷史，以及 Ayla Kol 信箱的詳細報告。 此範例使用暫存變數來儲存移動請求統計物件，並將移動報告輸出為 CSV 檔案。
參數
-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 |
-CopyOnServer
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
CopyOnServer 參數用於從指定伺服器上特定資料庫副本中擷取統計資料。
您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
Exchange Legacy DN
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Database
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Database
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
資料庫參數回傳指定資料庫中所有信箱的統計資料。 您可以使用唯一識別資料庫的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
此參數接受 Get-MailboxDatabase cmdlet 的管線輸入。
參數屬性
| 類型: | DatabaseIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Database
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | 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 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
Filter 參數使用 OPATH 語法，依照指定的屬性與值來篩選結果。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。
- 將整個 OPATH 濾波器包在雙引號中 “”。 如果篩選條件包含系統值 (例如
$true、$false或$null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。 - Property 是可篩選的屬性。
- ComparisonOperator 是一種 OPATH 比較運算子，例如用於等值和
-like字串比較) (-eq。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。 - Value 是要搜尋的屬性值。 以單引號括住文字值和變數 (
'Value'或'$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用'$($User -Replace "'","''")'，而不是'$User'。 不要用引號包住整數或系統值， (例如，使用500、、$true$false，或$null) 。
您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
欲了解 Exchange 中 OPATH 過濾器的詳細資訊，請參見 「額外 OPATH 語法資訊」。
例如，要在特定信箱資料庫中顯示所有斷線的信箱，請使用以下語法： 'DisconnectDate -ne $null'。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Database
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Server
| 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 |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeMoveHistory
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
IncludeMoveHistory 開關會指定是否回傳包含已完成搬遷請求歷史的信箱額外資訊，例如狀態、旗標、目標資料庫、壞件、開始時間、結束時間、搬遷請求在不同階段的持續時間，以及故障代碼。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeMoveReport
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
IncludeMoveReport 開關會指定是否要對已完成的移動請求（如伺服器連線與移動階段）回傳冗長且詳細的移動報告。 您不需要使用此參數指定值。
因為這個指令的輸出內容很冗長，你應該把輸出送到 .CSV 檔案，方便分析。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludePassive
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
IncludePassive 開關指定是否回傳所有主動與被動資料庫副本的統計資料。 您不需要使用此參數指定值。
如果你不使用這個開關，這個指令只會從活躍的資料庫副本中取得統計資料。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeQuarantineDetails
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
IncludeQuarantineDetails 開關會指定是否要回傳未包含在結果中的信箱隔離資訊。 你可以利用這些資料來判斷信箱何時以及為何被隔離。 您不需要使用此參數指定值。
具體來說，此交換器會回傳信箱上的 QuarantineDescription、QuarantineLastCrash 和 QuarantineEnd 屬性的值。 要查看這些數值，你需要使用格式化 cmdlet。 例如，Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeSoftDeletedRecipients
適用：Exchange Online
此參數只能在雲端式服務中使用。
IncludeSoftDeletedRecipients 開關會指定是否包含軟刪除的信箱。 您不需要使用此參數指定值。
軟刪除的信箱是指仍可恢復的已刪除信箱。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoADLookup
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
NoADLookup 交換器規定資訊是從信箱資料庫取出，而非從 Active Directory 取出。 您不需要使用此參數指定值。
此切換有助於提升 cmdlet 在查詢包含大量郵箱的信箱資料庫時的效能。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
Server 參數會指定您要取得其信箱統計資料的伺服器。 您可以使用下列其中一個值：
- 網域全名 (FQDN)
- NetBIOS 名稱
當你為伺服器參數指定值時，指令會回傳該伺服器上所有資料庫（包括復原資料庫）所有信箱的統計資料。 如果不指定此參數，則命令會傳回本機伺服器的登入統計資料。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-StoreMailboxIdentity
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
StoreMailboxIdentity 參數在與資料庫參數搭配使用時，指定了該信箱的身份，以回傳指定資料庫中單一信箱的統計資料。 您可以使用下列其中一個值：
- MailboxGuid
- LegacyDN
使用此語法來取得關於已脫離連接的信箱資訊，這些信箱沒有對應的 Active Directory 物件，或有對應的 Active Directory 物件，但該物件在信箱資料庫中不指向已斷開的信箱。
參數屬性
| 類型: | StoreMailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Database
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UseCustomRouting
適用：Exchange Online
此參數只能在雲端式服務中使用。
{{ 填寫 UseCustomRouting 描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。