Get-StoreUsageStatistics
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-StoreUsageStatistics 指令程式,來協助診斷伺服器或資料庫的效能問題。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Database
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Identity
Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Server
Get-StoreUsageStatistics
-Server <ServerIdParameter>
[-IncludePassive]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Description
Microsoft Exchange 資訊儲存庫收集每位使用者的延遲、輸入/輸出 (I/O) 、頁數、處理器使用率及 TimeInServer 等資訊。 TimeInServer 指標代表使用者信箱中同步與非同步請求在 Microsoft Exchange 資訊儲存庫中所花費的總時間。 你可以在 Microsoft Exchange 資訊庫中取得指定資料庫中使用率最高的 25 個帳號的資源資訊。 信箱的使用定義為伺服器在執行該信箱操作時所花費的時間長度。 指令長報告了過去 10 分鐘內每 1 分鐘內前 25 名用戶 (每 10 分鐘區間 250 個物件) 。 資源使用量反映了不同使用者對伺服器施加的負載。
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-StoreUsageStatistics -Server EX1 | ft -auto
這個範例會擷取伺服器 EX1 上所有主動資料庫的儲存區使用量統計資料。
範例 2
Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto
這個範例會擷取伺服器 EX1 上所有主動和被動資料庫的儲存區使用量統計資料。
範例 3
Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto
此範例取得資料庫 DB1 的儲存使用統計,並依據 10 個最高的日誌檔案產生器排序輸出。
參數
-CopyOnServer
適用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
CopyOnServer 參數指定了信箱資料庫的複製,以便取得使用統計資料。 你可以使用任何能唯一識別信箱資料庫的值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
你可以用這個參數搭配伺服器或身份參數。
參數屬性
| 類型: | 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
資料庫參數指定信箱資料庫名稱,以取得該郵箱資料庫) 中前 25 個最大郵箱的使用統計數據 (。 你可以使用任何能唯一識別信箱資料庫的值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
你不能用這個參數搭配身份或伺服器參數。
參數屬性
| 類型: | 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
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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 語法資訊」。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity 參數指定要從哪個信箱取得使用統計資料。 您可以使用以下其中一個值來識別信箱:
- GUID
- 辨別名稱 (DN)
- 網域/帳號
- 使用者主要名稱 (UPN)
- 舊有交換DN
- SMTP 位址
- 別名
這個指令只有在信箱是前 25 名商店資源使用者之一時才會回傳結果。
你不能用這個參數來搭配資料庫或伺服器的參數。
注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。
參數屬性
| 類型: | GeneralMailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludePassive
適用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludePassive 開關會指定是否包含你以伺服器參數指定的信箱資料庫中主動與被動副本的使用統計資料。 您不需要使用此參數指定值。
如果你沒有使用這個開關,結果只會包含來自信箱資料庫活躍副本的統計數據。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
伺服器參數指定郵箱伺服器,從指定伺服器) 上所有活躍資料庫中 (前25個郵箱的使用統計數據。 您可以使用以下其中一個值來識別伺服器:
- 網域全名 (FQDN)
- NetBIOS 名稱
你不能用這個參數搭配資料庫或身份參數。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。