共用方式為


Get-MailboxStatistics

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

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

注意:在 Exchange Online PowerShell 中,建議您使用 Get-EXOMailboxStatistics Cmdlet,而不是此 Cmdlet。 如需詳細資訊,請參閱<連線至 Exchange Online PowerShell>。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

Get-MailboxStatistics
   -Database <DatabaseIdParameter>
   [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-IncludeSoftDeletedRecipients]
   [-NoADLookup]
   [<CommonParameters>]
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。 For more information, see "Example 7," "Example 8," and "Example 9" in this topic.

您只能看到已完成移動要求的移動報表和移動歷程記錄。

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Get-MailboxStatistics -Identity AylaKol

此範例會使用其相關聯的別名 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

封存參數會指定是否要針對與信箱相關聯的封存信箱傳回信箱統計資料。 您不需要使用此參數指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CopyOnServer

此參數僅適用於內部部署 Exchange。

CopyOnServer 參數可用來從指定伺服器上的特定資料庫複本擷取統計資料。

您可以使用唯一識別伺服器的任何值。 例如:

  • Name
  • FQDN
  • 辨別名稱 (DN)
  • Exchange Legacy DN

Exchange Legacy DN

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

此參數僅適用於內部部署 Exchange。

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

  • 名稱
  • 辨別名稱 (DN)
  • GUID

此參數接受來自 Get-MailboxDatabase Cmdlet 的管線輸入。

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

此參數僅適用於內部部署 Exchange。

Filter 參數會使用 OPATH 語法,依指定的屬性和值來篩選結果。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"

  • 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如 $true$false$null),請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊),您也可以使用大括弧 { },但只有在篩選條件不包含變數時。
  • Property 是可篩選的屬性。
  • ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -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'

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定您要傳回統計資料的信箱。 您可以使用可唯一識別信箱的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveHistory

IncludeMoveHistory 參數會指定是否要傳回包含已完成移動要求歷程記錄之信箱的其他相關資訊,例如狀態、旗標、目標資料庫、不良專案、開始時間、結束時間、移動要求處於不同階段的持續時間,以及失敗碼。 您不需要使用此參數指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveReport

IncludeMoveReport 參數會指定是否要傳回已完成移動要求的詳細移動報告,例如伺服器連接和移動階段。 您不需要使用此參數指定值。

因為此命令的輸出是詳細資訊,所以您應該將輸出傳送至.CSV檔,以方便分析。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePassive

此參數僅適用於內部部署 Exchange。

IncludePassive 參數會指定是否要從所有主動和被動資料庫複本傳回統計資料。 您不需要使用此參數指定值。

如果您未使用此參數,此命令只會從作用中的資料庫複本擷取統計資料。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeQuarantineDetails

此參數僅適用於內部部署 Exchange。

IncludeQuarantineDetails 參數會指定是否要傳回其他有關未包含在結果中的信箱隔離詳細資料。 您可以使用這些詳細資料來判斷信箱被隔離的時機和原因。 您不需要使用此參數指定值。

具體而言,此參數會傳回信箱上 QuarantineDescription、QuarantineLastCrash 和 QuarantineEnd 屬性的值。 若要查看這些值,您需要使用格式化 Cmdlet。 例如,Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeSoftDeletedRecipients

此參數只能在雲端式服務中使用。

IncludeSoftDeletedRecipients 參數會指定是否要在結果中包含虛刪除的信箱。 您不需要使用此參數指定值。

虛刪除的信箱會刪除仍可復原的信箱。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-NoADLookup

此參數僅適用於內部部署 Exchange。

NoADLookup 參數會指定從信箱資料庫擷取資訊,而不是從 Active Directory 擷取資訊。 您不需要使用此參數指定值。

此參數有助於改善查詢包含大量信箱的信箱資料庫時的 Cmdlet 效能。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

此參數僅適用於內部部署 Exchange。

Server 參數會指定您要取得其信箱統計資料的伺服器。 您可以使用下列其中一個值:

  • 網域全名 (FQDN)
  • NetBIOS 名稱

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

Type:ServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-StoreMailboxIdentity

此參數僅適用於內部部署 Exchange。

StoreMailboxIdentity 參數會指定與 Database 參數搭配使用時的信箱識別,以傳回指定資料庫上單一信箱的統計資料。 您可以使用下列其中一個值:

  • MailboxGuid
  • LegacyDN

使用此語法來擷取已中斷連線信箱的相關資訊,這些信箱沒有對應的 Active Directory 物件,或具有對應的 Active Directory 物件,且該物件未指向信箱資料庫中已中斷連線的信箱。

Type:StoreMailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

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