Get-MailboxStatistics

模組:
Exchange PowerShell

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

使用 Get-MailboxStatistics Cmdlet 傳回信箱的相關資訊，例如信箱的大小、所包含的郵件數目，以及上次存取的時間。 此外，您還可以取得已完成移動要求的移動歷程記錄或移動報告。

注意：在 Exchange Online PowerShell 中，建議您使用 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

只在信箱伺服器上，您可以使用不含參數的 Get-MailboxStatistics Cmdlet。 在此情況下，Cmdlet 會傳回本機伺服器上所有資料庫上所有信箱的統計資料。

Get-MailboxStatistics Cmdlet 至少需要下列其中一個參數才能順利完成：伺服器、資料庫或身分識別。

您可以使用 Get-MailboxStatistics Cmdlet 傳回詳細的移動歷程記錄，以及已完成移動要求的移動報告，針對移動要求進行疑難排解。 若要檢視移動歷程記錄，您必須將此 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 來擷取使用者 Ayla Kol 信箱的信箱統計資料。

範例 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 Cmdlet，則不會顯示移動歷程記錄。

範例 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory

$temp.MoveHistory[0]

此範例會傳回 Ayla Kol 信箱之已完成移動要求的詳細移動歷程記錄。 此範例使用暫存變數來儲存信箱統計資料物件。 如果信箱多次移動，則會有多個移動報告。 最後一個移動報告始終是 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。

Database 參數會傳回指定資料庫上所有信箱的統計資料。 您可以使用唯一識別資料庫的任何值。 例如：

  • 名稱
  • 辨別名稱 (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 比較運算子 (例如 -eq ，用於等號和 -like 字串比較) 。 如需比較運算子的詳細資訊，請參閱 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 名稱

當您指定 Server 參數的值時，命令會傳回指定伺服器上所有資料庫上所有信箱的統計資料，包括修復資料庫。 如果不指定此參數，則命令會傳回本機伺服器的登入統計資料。

參數屬性

類型: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 參數會指定與 Database 參數搭配使用時的信箱身分識別，以傳回指定資料庫中單一信箱的統計資料。 您可以使用下列其中一個值：

  • 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

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