Get-UsageAggregates
取得回報的 Azure 訂用帳戶使用量詳細數據。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
Get-UsageAggregates
-ReportedStartTime <DateTime>
-ReportedEndTime <DateTime>
[-AggregationGranularity <AggregationGranularity>]
[-ShowDetails <Boolean>]
[-ContinuationToken <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-UsageAggregates Cmdlet 會依下列屬性來匯總 Azure 訂用帳戶使用量數據:
- 回報使用量的開始和結束時間。
- 匯總精確度,每天或每小時。
- 相同資源之多個實例的實例層級詳細數據。 為了取得一致的結果,傳回的數據是根據 Azure 資源報告使用量詳細數據時所依據。 如需詳細資訊,請參閱 Microsoft 開發人員網路連結庫中的 Azure 計費 REST API 參考https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c)。
範例
範例 1:擷取訂用帳戶數據
PS C:\>Get-UsageAggregates -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"
此命令會擷取 2015 年 5 月 2 日和 5/5/2015 之間訂閱的報告使用量數據。
參數
-AggregationGranularity
指定數據的匯總精確度。 有效值為:每日和每小時。 預設值為每日。
類型: | Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity |
接受的值: | Daily, Hourly |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContinuationToken
指定先前呼叫中從響應主體擷取的接續令牌。 對於大型結果集,回應會使用接續令牌來分頁。 接續令牌可作為進度的書籤。 如果您未指定此參數,則會從 ReportedStartTime 中指定的一天或一小時開始擷取數據。 建議您遵循回應頁面中的下一個連結,但數據。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ReportedEndTime
指定在 Azure 計費系統中記錄資源使用量的回報結束時間。 Azure 是一種分散式系統,橫跨世界各地的多個數據中心,因此資源實際耗用的時間、資源使用量時間,以及使用量事件到達計費系統,也就是資源使用量報告時間之間會有延遲。 若要取得一段時間所報告訂閱的所有使用量事件,您可以依報告的時間查詢。 即使您依報告時間查詢,Cmdlet 仍會依資源使用時間匯總響應數據。 資源使用量數據是分析數據的實用樞紐。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ReportedStartTime
指定在 Azure 計費系統中記錄資源使用量的回報開始時間。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ShowDetails
指出此 Cmdlet 是否使用使用量數據傳回實例層級詳細數據。 預設值為 $True。 如果$False,服務會在伺服器端匯總結果,因此會傳回較少的匯總群組。 例如,如果您執行三個網站,根據預設,您將取得三行專案以供網站取用。 不過,當值$False時,相同 subscriptionId、meterId、usageStartTime 和 usageEndTime 的所有數據都會折疊成單一明細專案。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse